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INTROOUCTIOH 


Welcome to the world of COMPUTER GRAPHICS. The PLOTWARE-z* system 
consists of this manual, the software on the disks you received 
with your system, and your imagination. There are many ways to 
use the PLOTWARB-z*. You can draw charts and graphs of almost 
unlimited complexity. You can become artistic and draw complete 
pictures by using data from many sources. You can compose slides 
with the (optional) ornate fonts, by using everything from tex¬ 
tbook quality letters and Old English letters to many special 
characters. You can also attach PLOTWARE-z* to your own prog¬ 
rams. 

If you are an experienced computer user, and wish at this time to 
begin drawing graphs you may "LOAD UP“, enter "CHART" on your 
console and get started. Remember to press the ESC button to get 
out of trouble or to get helpful hints. 

If you prefer to peruse this manual before proceeding, we will 
begin with explanations of the construction of the PLOTWARE-z* 
MANUAL. 

A; INSTALLATION SECTION: 

This section explains the first steps of getting started, 
and customizing your system to a special graphics peripheral 
or a special system environment. 

B: INTERFACE SECTION: 

There are many possibilities in approaching the use of 
PLOTWARE-z*. This section tells more about how you can use 
it and helps you choose the approach which will best suit 
your needs. You may find it beneficial to come back to this 
section later, as you get mote proficient in the world of 
computer graphics. You will probably discover new, mote 
effective ways to do what your graphics dispalys. 

C: MENU DRIVEN SECTION: 

This is the quickest way to display your data. You probably 
will find a chart here among the many charts available that 
will suit your own needs. It all starts with the DRAW 
command. 

0: "GRAPHIT'SECTION: 

This is a question and answer method of making charts. If 
you like to "PILL IN THE BLANKS", USe GRAPHIT. GRAPHIT 
contains a data editor and tutorial hints which are built 
into most of the major GRAPHIT functions. It all starts 
with the GRAPHIT command in the CHART program. 

E: EXPANDING THE MENU: 

You will eventually want to expand the menu of the menu- 
driven approach if you use menus extensively. This lets you 
build specialized graphs, in whatever complexity you desire, 
and retain the easy approach to the PLOT'Ware-z* system which 
is inherent in this MENU-DRIVEN portion. Make this the key 
to your very own special graphics system. 


REVISION 1.4 


(6-83) 




PLOTVIARE-2* 


INTRODUCTION 


page: 2 


F: COMMAND FILE SECTION: 

This section acquaints you with COMMAND FILES, the heart of 
the PLOTWARE-z* systea. It talks of how they work, and shows 
how to build them. 

G: COMPILER LIBRARY SECTION: 

This is a "must" for any person who wishes to attach the 
system directly to their program. If you are just beginning 
in computers, avoid this section until you become familiar 
with one of the traditional compiler languages. 

H: DEVICE SPECIFICATION SECTION: 

If you need to attach a new plotting device (plotter, word 
processing printer, CRT, camera, etc.), or if you wish to 
modify the way the built-in software handles, all of these 
types of devices (programmers often refer to this as "dri¬ 
vers" or "handlers") use this section. It is also a good 
way to just "fiddle around" with the inner-most workings of 
PLOTWARE-z*. This section includes an example of how to 
build a new device into the software. This section should 
probably be avoided if you are just beginning in computers. 

I: DEFERRED DEVICE SECTION: 

This section is similar to the DEVICE SPECIFICATION SECTION, 
except that it is strictly for "deferred devices" like dot 
matrix printers. Here the plot must be prepared for drawing 
with just one trip through the printer, no matter how com¬ 
plex your drawing has been. This is often referred to as a 
•vector to raster scan conversion". It is the secret to 
attaching this type of device to the system. It Includes 
the source code and examples you will need to make this type 
of addition. 

J: OPERATION SECTION: 

This is the nitty-gritty information about how PLOTWARE-z* 
works, operationally. This section includes details about 
disk files, overlay files, and the like. Although this may 
bore you, remember that computers must be properly groomed, 
and the necessary details for this grooming are usually 
found by understanding the relationship between the software 
and your own particular computer system. As with any sof¬ 
tware package, PLOTWARE-z* may appear to emit certain errors 
which are undefined in this manual. This is because some 
simple rule of the computer has been violated and the error 
is actually being displayed by some "support software" such 
as the operation system of your machine. A good example 
would be found If you tried to store your data on a disk 
which was write protected. Bach computer system usually has 
a unique way to show errors of this nature. Your knowledge 
of this section combined with your knowledge of your own 
unique system and the knowledge of th^ data you wish to 
display, will lead to the answer for these "undocumented 
problems". 
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K: TECHNICAL REFERENCE SECTION: 

This is a detailed description of each module of PLOTWARE- 
z*. This section is sometimes referred to as the SYNTAX 
DESCIPTION of the system. It explains the "grammar rules” 
for all of the modules available in the command files or in 
the compiler library. This section is a must for the prog¬ 
rammer making new command files or writing a new program 
which will access the compiler library. It might also be 
referred to by main-frame programmers as a "programmer's 
reference". 

L: INSTALLATION DEPENDENT SECTION: 

By now, it should be apparent that the author of PLOTWARE-z* 
made this unique graphics program easy to modify and simple 
to expand. As you build the system into the package that 
suits you, take special care to place all of the listings 
that come from INSTALL or the other sections into this 
section. It should hold the directory content listing 
of your "work disks", including all items pertaining to your 
own customized system. This is YOUR section. It is in your 
best interest to keep it up to date. 
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INSTALLATION SECTION 

PLOTWARE-z is designed to be a universal tool to draw on all 
graph ICS dev ices that^ I*® attached to the iDicro~computer« It 
is not directed specifically at the scientist or engineer or at 
the financial planner or computer programmer. Hence, it has many 
different ways to meet the^ needs of each group of users. Because 
of this variety of uses, it is suggested that you do these two 
things before going into the actual installation and usage of 
your software. 

1. Install your graphics hardware and verify that it works. 
Most devices have simple check-out software with them. 

2. Select the manner in which you will use this package. You 
may, of course, use all of it to its maximum capacity, as 
any single part does not exclude the use of any other 
part. Usually, one will use one approach in preference to 
others. This will make the system requirements somewhat 
less when he makes up his "work disks" since the parts not 
used may be omitted. 

First, before proceeding any further, be sure to archive your 
system disks. NEVER USE THE ORIGINAL DISKS AS WORK DISKS! Besides 
the possibility of Murphy's law showing up and ruining your only 
copy^ of the software,^ ENERCOMP requires that you return the 
original, unmodified disks when periodic updates are distributed. 

If your dealer has already installed this package into your own 
T* skip this next part and go directly to the 
INTERFACE SECTION. 


INSTALLING TOUR HARDWARE 

(This part presents installation requirements) 

First consider some basic facts. These are pertinent to all 
systems. 


1. A certain amount of hardware and software knowledge is 
essential : how your operating system works, how each 
"*^^***>f® device is attached, how the corresponding opera¬ 
ting system "connection* is made via software. REMEMBER - 
NO SOFTWARE, NOT EVEN PLOTWARE-z , WILL OPERATE ON AN 
IMPROPERLY INSTALLED SYSTEM. 


2. You must have at least ONE GRAPHICS DEVICE in order to use 
PLOTWARE-z . 


3. You may install as many graphics devices as you like. 

There is no practical limit other than any limit your 
hardware may impose on you. The actual limit is devices 
PLOTWARE-z will consider is about*64,000 - attached at 
any one time. 
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4. DEVICES are grouped into two categories: DBPERRBO DEVICES 
and REAL-TIME DEVICES. 

5. OBPERREO DEVICES include all hardware which must print or 
display all of the picture in one step as the media (such 
as paper in a printer) is passed in one direction only. 
This means that the picture is drawn in "passes" by some 
device such as a print head of scanning electron beam in a 
regular pattern from right to left or left to right as the 
media is passed from top to bottom. In no case will the 
media be "backed up" to make more impressions on it. These 
devices are typically called "raster scan devices" and 
include dot matrix printers, certain graphics camera de¬ 
vices, and the like. 

6. REAL-TIME DEVICES actually draw the pictur^ as it is 
presented. That means they seem to actually draw a line, 
by some means peculiar to them, and therefore have the 
freedom of moving in any direction on the "page" or media 
used to display the picture. These include: GRAPHICS CRTs, 
PEN PLOTTERS, WORD PROCESSING PRINTERS, VECTOR FILM 
CAMERAS, RASTER SCAN CAMERAS with accessible raster pages 
or "smart controllers", and DISK FILE INTERMEDIATE 
STORAGE. 

7. All devices used are associated with a device TYPE. The 
more popular TfPES are installed in PLOTWARE-z* as you 
receive it. You may choose to install these in a way that 
is more convenient to you. As you eliminate devices that 
don't pertain to your system, you also make the disk space 
requirements smaller. 

8. Device TYPE 0,1,2, and 3 are reserved for OEPERRED DEVICES 
which means, of course that you may have a maximum of four 
of these types of devices at any given time. It also 
meansthat you may have four "modes" of operation of any 
one device at any given time instead of four devices. This 
usually is used to define density of pictures as you 
display then. For instance, TYPE 0 is "super dense" mode 
for the OKIDATA 84 printer and T)fPE 3 is "LEAST DENSE" 
(hence fastest) mode for that printer. 

9. TYPE 4 and all higher numbers up to about 64000 are re¬ 
served for REAL-TIME devices. The ENERCOMP COMPANY sug¬ 
gests that you use the following convention. 

TYPE 4 — Your pen plotter. 

TYPE 5 — Your graphics CRT. 

TYPE 6 — Your auxiliary plotter, usually a 

word processing printer 

DEVICE "TYPE" MAY BE SELECTED BY YOU when you exercise the 
program INSTALL. 
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OBVICB SPECIFICS 

(This pact presents specific requirements for device types) 

Here are some specific device requirements that will assist you 
in determining the suitability of a device for graphics work. In 
general, if the device does not meet these requirements, the 
device is not a graphics device. In particular, that device will 
not work with PLOTWARB*z*. This also specifies any specific 
requirements for devices to be used. 

1. DEFERRED DEVICES ” Dot matrix printers must be assigned to 
the "PRINTER* device of your computer if they ace to use 
the standard software without modification or further 
installation. This is usually referred to as the "CP/rt 
LIST DEVICE" in CP/M or as LPTl in MSDOS or PCDOS. It can, 
of course, be any other possible device if your system can 
logically assign it to the "PRINTER" via some "10 BTTE" 
capability such as STAT in CP/N or MODE in MSDOS or PCDOS. 

In multi-processing systems such as MP/M, the printers 
should be specifically specified via the appropriate 
statement before beginning your graphics session. 

2. DEFERRED DEVICES - Dot matrix printers must be one of the 
available devices supported if no additional programming 
is done. A partial list is shown here: 

ANADEX 

CITOH 

DATASOUTH DSIBO 
EPSON with ORAFTRAX 
OKIDATA 
NEC 

STAR GEMINI 

RUM INSTALL TO INSERT THE PROPER PRINTER TYPE PRIOR TO 
USING A DEFERRED DEVICE. 

The software includes the NAME of the device as pact of 
its necessary install sequence. Be sure that you know the 
brand name of your device prior to installation. 

3. DEFERRED DEVICES - Dot matrix printers and similar devices 
not specifically supported must be included in your system 
by installing a special "replacement subroutine" as an 
ASSEMBLY language code module. This is a very simple 
procedure (for people familiar with ASSEMBLY language of 
their machine) as the skeleton code is included on your 
disk software. The devices must have the following 
characteristics to be installed via this method: 

a. They must be "dot addressible* •by placing one or more 
"dots* evenly spaced across the path of the carriage, 
and be able to do this by manipulating from one to 
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eight of the "print head wires” or "dot driving de¬ 
vices" to do this. Multiple passes# wherein a second 
row of dots are laid in between the first tow of dots 
say be made to generate super-dense graphics pictures. 
This is sometimes called "interlaced" operation. It 
prints the even dots on one pass of the print head# 
then prints the odd dots on the second pass. This 
allows the printer to overlap the dots and produce a 
very smooth line. 

b. The device must have a consistent "dot density" both in 
the vertical and horizontal directions. These densities 
need not be identical. 

c. The device must be able to perform a "graphic carriage 
return and line feed* or some similar sequence that 
will serve to begin an new uniform entry of "dots" on 
the next segment of the page or media. 

4. REAL TIME devices must be connected to your computer as 
one of the standard operating system peripherals unless 
you install them specially with the INSTALL program# for 
specific 10 port addresses# or by modification of the 
plotter source code in PLOTSPEC.SRC. 

5. Some devices may be connected only to a few of the 
available devices. Por instance# the screen of the 
TBLCVIOEO 1603 or 803 must only be connected to the 
DISPLAY CONSOLE. Such restrictions are dependent on your 
own unique hardware# of course. 

6. Bach device supported must have the following 
characteristics in order to be "custom installed” by you. 

a. It must be able to draw a line (vector drawing) or be 
able to "turn on" a dot within its matrix on command. 

b. The grid on which the dots are located or on which the 
lines are drawn must be consistent in both the X and Y 
directions. The X and Y may be different in measure. 
This means that a consistent "steps per inch" or "dots 
per inch" must be available for the device. 

c. REAL-TIME device extensions in addition to the ones 
required above may be included by using the NEWPEN 
statement. These usually include such extensions as 
COLOR, LINE STYLE often specified in the CORE GRAPBIC 
standards# and special PILL with PATTERN commands and 
similar commands. 

INSTALLATION PILES 

(This part describes disk files that are used by installation 
program : INSTALL) 
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Now that you have patiently read through all of the ground rules, 
you can proceed into the installation procedure for your work 
disks. 

If you can get all of PLOTWARE-z* onto your work disk, do so. Xou 
can reaove the excess later. 

If not, place these files onto your first work disk: 

INSTALL.COM 
INSTALLl.OVR 
INSTALL2.0VR 
INSTALL3.0VR 
INSTALL4.0VR 

Then you may enter INSTALL as a CP/M command. 

If even these will not fit on your disk, include INSTALL.COM on a 
separate disk, assign the .OVR files to your default disk, and 
initiate INSTALL from the separate disk (for example : 
B:INSTALL). 

After the INSTALL command is issued to CP/M, the program will 
talk you through the rest of the procedure. Some miscellaneous 
details of this program follow: 

a. The COSTOMItB procedure lets you select specific devices. 

b. The PLOTCOMP procedure compiles the results of "a". 

c. "a" must be followed by "b* to completely customize your 
devices. This is by design, as it allows you to modify 
the file "PLOTSPEC.DAT" between the two steps if you 
desire to enhance the operation of any of the devices for 
your own particular reasons. 

d. The MODIFY program allows you the ability to directly 
modify parameters within the system. It is usually not 
required in most installations, but is included to allow 
the user to avoid such clumsy software as the DDT package. 

INSTALLATION OBTAILS 

(This part explains "difficult" errors and describes operating 
details of the INSTALL procedure) 

Skip this unless you ace curious about the workings of the 
install procedure. Read it if you have problems. 

Normally the INSTALL program will ask you questions. Install the 
system, give you specific information, give you specific direc¬ 
tions, then terminate. 

Certain errors may occur, however. Usually*-these ace self explan¬ 
atory, however, such as ; 
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"INSTALLl.OVR not on the disic." 

Other errors may occur that are not explained here, such as : 

"BOOS ERROR ON A;R/0" 

which means to the experienced computer user: "yoU PROBABLY 
CliANGEO DISKS DURING THIS PROCESS”. 

These are operational errors and must be resolved by you, since 
they pertain to your own computer system and all possible 
computer systems can not be covered in this manual. 

Here ace a few possibilities that you should consider: 

You did something wrong, just start over, and try again. 

You had insufficient disk space. You need 5 to 10 R of space on 
the "default disk" to run INSTALL. 

There were improper files on disk. Follow the directions, and re¬ 
do the procedure. 

There was a "write protect" device on the disk. Correct this and 
re-do the procedure. 

The primacy purposes of INSTALL are as follows: 

1. The generation of a disk file called PLOTSPBC.OAT which is 
the "brains" behind the operation of PLOTWARE-z* on your 
own particular system. You MUST have this file present 
whenever PLOTWARB-z* is used. It will be very small unless 
you have many plotter devices installed in your system. 


2. The generation of the optimal disk configuration for your 
own computer system. This will allow the most efficient 
operation of the package on your system. 

3. Inform you of any "last minute" operation notes. Any 
hints, any manual changes, or any explanation of vague 
areas in the documentation (which exist in all systems, of 
course) will be found here. When users call in hints, or 
ideas, or when new devices ace implemented in special 
ways, these notes will be Included in the INSTALL program 
so that you may have the very latest information on your 
system when it arrives. 

When PLOTSPBC.OAT is built, several things go into it: 

a. A concise description of your deferred devices. 

b. A complete description of your RBAL-TIHB devices. 
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c. A “snapshot” of your conputer systen (memory size, etc.) 
as needed for efficient operation of overlays, etc. 

NEVER MODIFY THE FILE PLOTSPEC.DAT — it could result in system 
failure. ALWAYS modify only those parameters needed to build 
this file (in PLOTSPEC.SRC or by INSTALL, for instance). 

INSTALL builds this file from several sources: 

1. Your responses to the INSTALL questions. 

2. The file PLOTSPEC.SRC used to describe real-time devices. 
This file is specifically made available to the user in 
order to allow him the freedom of modifying current 
devices or installing new devices in whatever manner he 
chooses. This is sometimes calles "device drivers” or 
"device handlers" by main-frame and minicomputer 
programmers. Remember to incorporate any desired changes 
into this file prior to using the "PLOTCOMPPROCEDURE^in 
INSTALL, if you wish to make changes. 

3. The file which handles your dot matrix printer(s). These 
go by different names and may be modified if you have 
special dot-matrix printer requirements. This information 
in PLOTSPEC.DAT includes routine information items such as 

a. Type of interface. 

b. Dots-per-inch in both directions. 

c. The kinds of "resolution density" available - if your 
printer has this feature. 

INSTALLING THE FILE PLOTSPEC.DAT ON YOUR WORKING DISKS 

(This describes, in summary, the building of the file onto a 
working disk) 

These are the normal steps used to modify the file PLOTSPEC.DAT 
and implement the changes. 

The process for REAL-TIME devices: 

1. Run INSTALL and select the "CUSTOMIZE ..." option in order 
to obtain the file PLOTSPEC.SRC. You must have the file 
INSTALLl.OVR on your default disk when this is done. 

2. If you wish to enhance Che standard devices in any way, or 
if you must do special things to implement your.device, 
use your favorite text editor or word processing program 
to modify PLOTSPEC.SRC. BEWARE OE "HIGH-BIT" errors. Do 
not use a text editor that sets the "high bit" (bit 7) of 
the ASCII data. Host processors find that this means 
something very special - it ignores' any item with this bit 
sec. A common mistake is found when WORDSTAR is used in 
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the "D" oc document mode instead of the "N" oc non-docu¬ 
ment mode to modify this file. 

3. Run INSTALL and specify the "PLOTCOMP PROCBOORB" to 
process the file PLOTSPBC.SRC and compile it into 
PLOTSPBC.DAT. You will have a chance to get a listing of 
the code, if desired. 

4. Copy the new file PLOTSPBC.DAT onto the working disk. 
This is the only information that you need on that disk 
from this installation process. 

5. Store the PLOTSPBC.SRC file in your archives and include 
the PLOTSPBC.SRC listing in the "INSTALLATION OBPBNOBMT* 
section of this manual. 

The process for deferred devices: 

1. Use INSTALL to install the desired dot matrix printer 
device. If the device is in the standard software, this 
step is sufficient to install it. 

2. Your file PRINTMAP.COH must be on the working disk. This 
file can be modified in the areas specified as available 
to you for modification. After modification, place the 
new PRINTHAP.COM onto your working disk. 

3. If the dots-per-inch specification has changed during this 
process, you must re-run the INSTALL program to re-specify 
the dots-per-inch specifications to the system. 

4. If you have changed printers, you must re-run INSTALL to 
obtain the proper printer environment. 

Now you can sake any necessary changes in your work disk as 
directed by INSTALL. The only files affected by this procedure 
are PLOTSPBC.DAT, CHART.COM, and PRINTMAP.COH. 

CHECKING OUT THE INSTALLATION: 

(This part describes a simple way to verify that your hardware 
works in the proper fashion. It is used after "custom 
installations* as well as after standard menu selection 
installations.) 

For PLOTWARS-x* packages: 

Verify installation by performing the following steps: 

you ENTER THE COMPUTER RESPONDS 

CHART . COMMAND: 

PLOTS TYPE n 
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(use your own value for n) 

COHMANO: 


PLOT 362302002 END 

COHMANO: 

At this time, if a real time 
device was selected, a right 
triangle should have been drawn, 
with a three inch leg and a six 
inch leg. If you used a device 
that shared the computer console 
with you (like an APPLE II screen) 
some conflict may have been 
encountered with the graphic 
screen activity versus the text 
activity. 

EXIT 

At this time the program will terminate. If you used a deferred 
device, the right triangle will be drawn before the program 
terminates. 

Poc OSBR PROGRAMS (all other systems ~ not PLOTMARE~z*) 

Run the program GRAFTEST. It will prompt you to answer the TYPE 
question, then it will allow you to run the same "triangle test" 
as well as a simple test of the character generator and a few 
other things. 

AMO IP IT DOESN'T WORK? Try these remedies: 

1. You may have a hardware error or an improperly installed 
device. Correct this. 

2. You nay have incorrectly installed the software. Be sure 
there are no missing disk files. Correct any errors. 

3. Perform the test until it works. 

IP THE TRIANGLE IS DISTORTED: The legs may not measure 3 inches 
by 6 inches. If so, continue: 

1. For REAL-TIME devices: Often one uses a different size 
device. For example, on a CRT or graphics card, one may 
install a variety of monitors, any of which may have a 
different "ASPECT RATIO" than another. You may also have 
a plotter with METRIC stepping motors instead of INCH 
stepping motors. Your plotter may have a switch that 
allows you to choose different step sizes. There is a 
simple solution to this in the file PLOTSPEC.SRC. Refer to 
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the DEVICE SPECIFICATION SECTION foe inforaation on the 
"MECHANICAL" specification of this file. A standard prac¬ 
tice in ENERCOMP has been to "size" the CRT screen to a 10 
inch height in order to allow a compatibility with most 
^'sed-copy devices. This obviously makes the triangle smal¬ 
ler, but is usually acceptable to those who want this 
compatibility. A side effect of this is that it usually 
makes the screen appear to be 12 or 13 inches "wide". 

2. DEFERRED DEVICES. Surprisingly enough, ENERCOMP has found 
that some dot-matriz printers will vary in the step size, 
or "dots per inch" between supposedly similar models. This 
is usually only in the dots-per-inch across the page. It 
usually results from a different "micro-code" program in 
the printer, and can be explained by the manufacturer's 
revised program. The quickest way to fix this is to 
measure the triangle and form the ratio needed to correct 
the error. For example, if the 6 inch leg measured 5 
inches when drawn, the ratio would be 6/5. Now run INSTALL 
again. When you choose the printer type, enter a "dots- 
P®f“inch in the Y direction" (which is across the page) 
that is 6/5 of the value previously entered. 

If the triangle is distorted (just has lines not connected 
or not straight), you may have one of the following 
deferred device problems: 

1. A HARDWARE PROBLEM. Usually a handshake problem. This 
occurs most frequently with older EPSON printers with 
GRAFTRAX software which had "bugs" in it. 

2. You are not sending enough bits to the device. On EPSON 
aiyl STAR GEMINI and similar printers, you must send all 8 
bits of the byte in order to correctly make the graph. 
There is a switch on most interfaces that allows the 
"eighth bit to be grounded*. This switch will create 
problems in graphics mode, if set. 

For real-time devices: 

1. You may have made an error while "customizing the system*. 
Correct it. 

2. You may need to specify a different "step size*. Do so. 
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INTERFACE SECTION 


mere are several aiffecent ways to use PLOTwARt-z. Each way is 
called an "interface method". Each method described here is 
directeo at a specific approach to using PLOTv^ARE-z. 


APPROACH 

INTERFACE METHOD 

1. Computer asks questions. 

User answers questions. 

"DRAW* 

2. Computer shows "screen". 

User "fills in the blanks*. 

"GRAPHIT" 

3. User prepares commands into 
disk file. Computer reads 
"COMMAND FILE" as a "program". 

"COMMAND FILE" 

4. User writes traditional "program 
"COMPILES" it and"LlNKS" it with 
PLOTWARE-z library. 

• 

"COMPILER LIBRARY 


Each of these interface methods will be described separately. 
Use this section to build a basic familiarity with each way and 
to necome familiar with the basic computer operating details of 
each. 

DRAW: 

’raw IS the easiest way to get started with PLOTWARE-z. It asks 
.uestions, then produces graphs and charts from your answers. 
The “standard graphs" are all ouilt into the system when it is 
delivered. However, if you wish to add to these "menus", it is 
very easy to do so. A basic understanding of the COMMAND FILES 
IS required and some means by wnicn to re**arrange the menus is 
necessary. This re-arrangement may be done with any text editor 
such as WORDSTAR. Completely new menus may be included and 
existing menus may be customized specifically for your needs. 

Examples of using this approach are found in the "MENU DRIVEN 
SECTION (C)". Explanation of the process of building new menus 
and mooifying existing ones is found in the "EXPANDING THE MENU 
SECTION (E)". 

GRAPHIT: 

This program is meant to build "generic plots" and to prepare a 
command file in order to allow further enhancements of the chart. 
In aadition to this, graphit contains a handy data editor which 
allows one to edit the data from a variety of sources into the 
necessary disk file format. Tne format of this approach is to 
present screens for "filling in the blanks", and to produce the 
necessary command files to generate charts based on these 
screens. All menus iiave explanations about their function. All 
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menus which produce graphs or charts include a pictorial repre¬ 
sentation of the final graph together with all available options. 
This does not require a graphics screen to function. Exampir-s oj 
this approach are included in the "GRAPHIT SECTION (□)". 

COHHANO FILE 

All PLOTWARE-z operations except the compiler library begin or 
end in this section. It is the most important feature of 
PLOTWARE-z from an operational viewpoint. All other interface 
methods (except the compiler library) generate the COMMAND FILE 
language that is discussed here. All other processes also leave 
this language available to you in a source file format so that 
you may modify or enhance it in any way you choose. This allows 
you the total flexibililty of dynamically altering the files to 
give your results "that custom look". The process consists of 
generating a "COMMAND FILE" by using a text editing program or 
some other program and then allowing the program "CHART".COM" to 
process this file and yield the requested chart. The command 
file consists of a kind of "language" with simple, Engilsh-like 
verbs which have modifiers to further explain the command. A 
complete explanation of this language is found in the "TECHNICAL 
REFERENCE SECTION (K)" as well as examples for using command 
files. 

This approach can also be used by programs written in BASIC or 
other interpretive languages and compiled programs. The process 
consists of building the command file from the program and 
building any data files which the command file may reference. 
(The data may be included in the command file if desired, 
however). The program then "chains" to the "CHART.COM" program 
which processes the command file. The CHART sequence may then 
restart the original program,if so desired. There is an example 
of this approach later in this section showing a partial 
derivative and directional derivative function described in a 3-0 
manner through PLOTWARE-z. 

This entire "chaining" process revolves around a base file called 
"PLOTWARE.OVR" and if the user has files named by this name or if 
the file resides on some disk improperly, very strange things may 
occur. These can be corrected by removing any file by the name 
"PLOTWARE.OVR" which is on the default disk. This file is built 
when needed and erased later in normal operations. 

When the user generates "PLOTWARE.OVR" to control chaining BACK 
to his original program after PLOTwARE-z processes his (gener¬ 
ated) files, the user needs only to generate a file with at least 
one record in it. The first byte of this record is a binary 
designation of the disk on which his program resides (0 ■ default 
disk, 1» "A", etc.) and positions 2-12 define the program name 
which is to be restarted. The remainder of the file should be 
used to house any common data necessary tO"his program. The 
PLOTWARE-z system will leave this data intact. The command file 
should be named COMMON.CMD and the file PLOTWARE.OVR should be 
erased after the original program regains control of the system. 


REVISION 1.4 


(6-B3 ) 







PLOTWARE-2* 


INTERFACE SECTION 


page;B-3 


Another feature of this language is its ability to automatically 
"RESTART" after some catastrophic (to the computer system) event. 
If the computer experiences a power failure during the PLOTWARE-z 
process, the user needs only to restart the phase program (such 
as CHART or PRINTMAP) that was last active. The entire process 
will then continue as though nothing occurred. This is an 
effective way to run the lengthy processes sometimes necessary an 
retain a level of system confidence. 

This feature uses tne file PUXTWARE.OVR and if the (interrupted) 
process is NOT to be restarted, this file must be manually 
removed to avoid the automatic restart of the LAST PLOTWARE-z 
process whenever a PLOTWARB-z phase again executes in the 
machine. This is especially true if logic or data errors (such as 
feeding negative numbers to a LOG-LOG chart) result in a fatal 
error in a PLO'fWARE-z phase program. The error occurs and leaves 
the restart file intact so that you can correct the logic or data 
error (remove the negative numbers in the above example, for 
example) and then restart the process without the necessity for 
all of the preliminary "set-up" exercises. 

All of the COMMAND FILES used to illustrate the TECHNICAL 
REFERENCE SECTION (E) are listed to allow you to see how each 
works. These are at the end of that section. 

COMPILER LIBRARY 

This method allows the programmer to directly attach PLOTWARB-z 
to his program. This is normally done by the process of 
"LINKING* his program to the necessary pieces of the compiler 
library. Thisptocess is normally explained in the appropriate 
compiler manual, but will be covered here by example. 

The graphic process usually begins by the statement; 

CALL PLOTS (A,B,ITYPB} 

and ends by the statement: 

CALL PLOT (0., 0., 999) 

which terminates that graphics program normally. 

The syntax associated with the calls is found in the"TECHNICAL 
REFERENCE SECTION (K)". 

The library makes external calls for arithmetic subroutines. 
This allows the programmer to include common subroutines for his 
programs as well as PLOTWARE-z and to take advantage of any 
special hardware he might have available. Input/output subrou¬ 
tines used by PLOTWARE-z are included and external routines are 
not needed. 


REVISION 1.4 


(6-83) 






PLOTWARE-z* 


INTERFACE SECTION 


page:B-M 


EXAMPLE : BASIC AND PLOTUARE-z 

This exaaple shows the use of a BASIC program written in 
interpretive MICROSOFT basic using PLOTWAHE-z as an auxiliary 
program. The program generates a 3-^^ data file and then generates 
the command file to draw the picture. 

1 IPEN«3:G0SUB 2000 

3 XMAX«-9999:TfMAX«-9999:ZMAXc-9999:XMINc9999; YMIN*9999:ZMIN«9999 
5 YISc-8:XlS«8: YIS2c8:XlS2«-9:NEW*(XIS2-lfIS)/(XIS2-XIS) 

10 FOR X.IA TO -18 STEP -ItFLAGcO 
20 REM ¥NEW«YIS>(X-XIS)«NEW 

30 REM FOR YcYNEW TO 1? STEP .5 

31 FOR Y.-13 TO 17 STEP .5 
1(0 GOSUB 1000 

50 PRINT#1,X;Y;Z;IPEN 

52 IF X<XHIN THEN XMIN.X 

53 IF X>XMAX THEN XHAX>X 

54 IF Y<YMIN THEN YMINcY 

55 IF Y>YMAX THEN YMAX.Y 

56 IF Z<ZMIN THEN ZMIN.Z 

57 IF Z>ZHAX THEN ZMAX«Z 

58 IPEN«2 
60 NEXT Y 
62 PRINT X 

65 IPEN«3:NEXT X 

66 PRINT|1,XMIN;YMIN;ZMIN;'* 3'': PRINT# 1,XMAX; YMAX;ZMAX;*• 3'':CLOSE #1 

67 PRINT XMIN;YMIN;ZMIN;XMAX;YMAX;YMAX 

68 PRINT #2,"EXIT"(CLOSE #2 

69 IF NA1$«"C0MM0N.CMD" THEN GOTO 3000:REM IF NAMED "COMMON.CMD" THEN CHAU 

70 STOP 

1000 WX«3*EXP(-.1»((Y+10)*2)-.02»((X+10)“2)) 

1010 KX«4«EXP(-.l«((X+10)*2)-.3»((X-6)*2)) 

1020 SX.3«EXP(-.l«((Y+8)*2)-.02«((X-10>*2)) 

1030 UXc-6«EXP(-.09»(X-5)*2-.09*(Y-7)*2) 

1040 Z.UX-i-RXfWX-i-SX 
1050 RETURN 

2000 INPUT "INPUT COMMAND FILE NAME (•name *.CMD)";NA1 $ 

2005 NA1$«NA1$4-".CHD" 

2010 INPUT "INPUT DATA FILE NAME ('name*.DAT)";NA$ 

2011 Q«CHR$(34) 

2015 NA$.NA$4.".DAT" 

2020 INPUT-INPUT PLOT DEVICE (NUMBER)";PD 
2022 0PEN"0",#1,NA$:0PEN "0",#2,NA1$ 

2025 PRINT #2,"PLOTS TtPE ";PD 
2030 PRINT #2,"PLOT 65-3 END" 

2035 PRINT #2,"FACTOR .5" 

2040 PRINT #2,"ZPERSX 80 22.9183 71.6198 25 0" 

2045 PRINT #2,"FONT ROMAN" 

2050 PRINT #2,"FONTFQ 1 1.2" 

2055 PRINT #2,"FONTFQ 20" 

2060 PRINT #2,"FONTFQ 3 0" 

2065 PRINT #2,"F0NTFg 4 1" 

2070 PRINT #2,"FONTFQ 5 0" 

2075 PRINT #2,"F0NTFW 6 0" 
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2080 PKINT #2,"SM80LC 23.5 5 2.8 ‘ENEHCOMP' 90 99" 

2085 PHINT #2,"PLOT (-1 0 0 0)«;Q;NA$;Q 
2100 RETURN 

3000 Ic^OOOO!:REM BEGIN CHAINING PROGRAM AT 40000 

3010 FOR J«1 TO 61 

3020 READ K:POKE I,K:I«l*1:NEXT J 

3030 FOR J.l TO 24 

3040 POKE I,0:IcI+l:NEXT J 

3050 DEF USH0c40000! 

3060 AcUSRO(A) 

3070 DATA 17 , 113 . 156 , 14 , 15 , 213 , 205 , 5 , 0 , 209 ,25*1,255,202,0,0, 33,0, 1 
3080 DATA 235,213,229,14,26,205,5,0,225,209,1,128,0,235,9,229,213 
3090 DATA 14,20,205,5,0,209,225,183,194,0,1,195,82,156,0,67,72,65 
3100 DATA 82,84,32,32,32,67,79,77 

EXAMPLE - COMPILER LIBRARY 

This program illustrates the use of the COMPILER library. It is 
written in FORTRAN with Microsoft's F80 compiler. 


LOGICAL L(255) 

CALL MAINR 

C- THIS MUST ALWAYS HAVE "ROOM" AT THE LOWER PART OF MEMORY FOR 
C- THE TRANSIENT REAL-TIME DEVICE ROUTINES WHICH BEGIN AT 145H 
END 

SUBROUTINE MAINR 
C- THIS IS THE ACTUAL PROGRAM 

C- ALWAYS COMPILE YOUR PROGRAMS LIKE THIS, OR LINK A "DUMMY" 

C- ROUTINE TO BEGIN WITH THAT HAS ENOUGH ROOM FOR THIS. 

WRITE(5,1) 

1 FORMAT!* Enter the index of your device ("TYPE") ;') 
READ(5,2)I 

2 FORMAT(I4) 

CALL PLOTS(0.,0.,I) 

C- THIS INITIALIZES THE DEVICE 
CALL PLOT (0.,0.,3) 

CALL PLOT (4.,0.,2) 

CALL PLOT (4., 6 .,2) 

CALL PLOT (0.,0.,2) 

C- THIS JUST DREW A 4 INCH BY 6 INCH TRIANGLE 

CALL SMBOLL(5.,0.,.5,'ABCDEF123456',90.,12) 

C- THIS JUST PLOTTED 12 CHARACTERS 1/2 INCH HIGH AT 90 DEGREES 
CALL PLOT (0.,0.,999) 

C- THIS TERMINATES 
END 


The following submit file will compile and link the program 
F80 cTESTLlBR 

L80 TtSTLIBK,PLOTLIB/S,FORLlB/S,TESTLIBH/N/E 

To execute the program (the standard S.t.T.S test), enter: 


TESTHBR 
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MENU DRIVEN SECTION 

The nenu driven section allows the person to make direct question 
and answer graphs. There is very little to explain about this 
except to show how to begin the session: 

Enter: 

CHART 

When prompted to respond, enter: 

DRAW 

The computer will then be in the MENU DRIVEN SECTION. 

You may enter the ESC command to look at directories, get general 
help information, or perform other tasks, as indicated. 

You may enter the ? code to get specific help about certain 
options of this format. 

To take full advantage of this section, use it as you would use 
any software package, with one exception: 

a. Hake a note to yourself of EVERY little thing you would 
change if you could do so. 

b. After compiling all of these notes, or at least enough of 
them to make the process worthwhile, don't curse the 
PLOTWARE-z authors as you have other authors that have left 
you limited to the "standard options" of typical software. 
Instead, include these changes into the menus that you have 
found that you use the most. 

c. Familiarize yourself with the COMMAND FILE language. You 
will probably already have accomplished this by this time. 

d. Use the "EXPANDING THE MENU SECTION" as a guide to effect 
your changes. 

e. Now you can use your OWN CUSTOMIZED GRAPHICS SOFTWARE 1 
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GRAPHIT” SYSTEM 


The "GRAPHIT" system consists of a separate program call 
GRAPHIT.COM with its corresponding overlay file called 
OVERLAYG.OVR, and the necessary code to "chain* to the CHART 
system to process the command files that are built in GRAPHIT. 


The system consists of two different types of solutions. One is a 
collection of "screen menu" routines that allow you to specify 
the necessary items to build a chart or graph for all of the 
common types of charts and graphs. It is.very fast because all 
you ever need to enter is the name of the file which houses your 
data. 

The other type of routine is a set of "editing" routines that 
allow you to take data from other disk files or from the computer 
console keyboard and build data files for charting and graphing. 


In both cases, no manual is needed to run the system 
presents sufficient information for its "screen menus" and 
a compact set of editing rules whenever any error is 
allowing the user to correct the error. 


as it 
gives 
made. 


BUILDING DATA for the GRAPHIT system. 

The GRAPHIT system produces graphs and charts from a varietyof 
data sources. 


a. Data entered manually. 

b. Data from electronic "spread sheet" programs. 

c. Data from disk files created by BASIC programs or other 
programs. 

d. Other ASCII data files. 

Data taken from other files must be from files having these 
character istics: 

a. The data must be in the ASCII format. 

b. The data must be numeric, without embedded commas, dol¬ 
lar signs, asterisks, or other special characters. 

c. The data must be in "columnar" format. For each record 
or line of data, the data must occur in the same position 
each time. The data does not actually have to occur in 
the same PHYSICAL columns, but must always be in the same 
position with respect to the other numbers. For in¬ 
stance, the user may always refer to the THIRD number or 
column in the record as the X value in a graph, and the 
FIFTH number or column as the Y value, when drawing line 
graphs. 
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d. The data may be included with certain alphabetic annota¬ 
tion or other items which need to be removed from consid¬ 
eration. This would include ALL items which are not 
numeric in nature. This data may be "blanked out" before 
the data is editted into the users data file. The posi¬ 
tions within the line must be known to do this. EXAMPLE 
: Take the following data extracted from a printed list¬ 
ing from a "spool" file: 

May, 1981 14.7 12.3 residual; 2.1 

June, 1981 12.4 11.1 residual: 1.7 

Here the dates and the item "residual:" must be "blanked 
out" from the rest/of the numeric data, leaving: 

14.7 12.3 2.1 

12.4 11.1 1.7 

This is done by specifying where the "blanked out" data 
resides, withrespect to the character position with the 
record. 

In the above case, position 1-17 would blank the data 
(with a couple of extra spaces for longer months), and 
41-49 would blank out the "residual:" item. These are 
also referred to as "columns" (which should not be 
confused with "columns" of numbers. The first column of 
numbers contains 14.7 and 12.4, the second, column of 
numbers contains 12.3 and 11.1, etc.) 

The process is as follows: 

1. Select the "BUILD GRAPH DATA FILE" entry from the menu, 
(enter a "5"). 

2. Enter a name for your data file. 

3. Enter a title for your data file. 

4. Enter a short description for the file. 

The optional items 3 and 4 have been included in each file 
to allow for more detailed information to be stored in each 
file. This will make future use of the file more simple 
since the data is adequately identified. 

The GRAPHIT program itself will explain each response requested. 
If any typical errors are made, such as selecting a file name 
which already exists on disk, you will be told about this and 
your options will be explained. 

You must then tell what kind of file you wish to build: 

1. A file for X-Y graphs (each record holds 2 numbers) 

2. A file for simple bar charts or for pie charts (each 
record holds a bar or segment title and a number.) 
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3, A file for "clustered" or "stacked bars" (2 high in this 
case). Each record holds a bar title and from 2 to 10 
numbers. Multiple stacked bars are handled in another 
way. 

You must then select how you will enter the data (manually or 
from a disk file). Manual entry is done by the data editor. 

When you select the automatic extraction from a disk file source, 
you will need to know these things: 

1. How many records you want to "skip" at the beginning 
of the file. These are usually titles. 

2. The exact location of fields to be blanked out, as 
shown above. 

3. The relative occurrence of the columns of numbers in the 
data file with respect to how you will use the data. For 
instance, you may choose to select the third column of 
the data file for your "X* values (which is your FIRST 
column), and the second column of the data file for your 
"Y" (which is your SECOND column). Don't be confused by 
which column is the data file and which is yours. 

These responses must be given in the above order. 

You may then decide just how you will process each record from 
the data file: 

a. You may look at each record and decide whether it is 
to be processed or bypassed. 

b. You may process all remaining records in the file. 

c. You may process only a certain number of records in the 
file. 

If you select option "a" or "c", you may decide again at the end 
of the records processed how to continue processing. You can go 
back to the beginning of the file, you can skip more records, you 
can redefine the "blank areas" or you can redefine how your 
"column structure" will match the data file's "column structure". 
The system explains this when you get there. 

When the data is extracted (either by reading through the entire 
data file, or by your choice to stop extracting data), the 
process begins the "data editting phase". 

EOITTING EXISTING DATA FILES 

The GRAPHIT system expects its data to be in a format that 
includes not only the data but certain items about the data 
structure (is it an X-Y data file, a PIE chart data file, etc.) 
as well as the extra information about the data that you may have 
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supplied when the data file as originally built. 

The editor (when selected originally by menu item ”4”) must be 
supplied with a name of the data file. If the data file is not in 
order, a message will be displayed. This is not necessary if you 
have elected to "BUILD” a data file through the menu item number 
"5”. It already has your data file name. 

You then may do one of the following five things: 

a. List your data (1 or more lines.) 

b. Print your data on the printer (1 or more lines) 

c. Delete a line of your data. 

d. Insert a new line into your data. 

e. Replace a line of data with a new line. 

f. ”AUT0* insert data into the data file. 

g. Save the edited data file. 

The experienced user will see a remarkable similarity between 
this approach and the editors used in the more common BASIC 
interpreters. This is designed to eliminate the need to learn 
more and more editors and their peculiarities. 

The data will have a "line number” which begins with 1 and 
proceeds upward. All operations must refer to this line number 
(except the SAVE operation). 

Only the first letter of each operation is needed when editting 
(as explained by the program when it runs), and if an error is 
made, the editor re-displays the rules of editting. 

The only exception to the single letter command is found in the 
"SAVE* command. You must first enter an "empty” command (RETURN 
key only), and then enter S or SAVE. This is to avoid the 
accidental "saving" of a file and the subsequent need to re-edit 
it, due to the relative close proximity of the ”S” key to the "0" 
and "R” keys. 

The file must be "SAVED" to exit this procedure (unless you press 
the control-c key, which will cause your data file to remain as 
it was at the last "SAVE" command, and will exit to the operating 
system.) 

An example: 

NOTE THAT ALL COMPUTER "VERBAGB* IS IN DARKER LETTERS. 

NOTE: ALL OPERATOR ENTRIES ARE UNDERLINEDt I!U 

Let's enter some data manually into the system. 
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We begin by starting GKAPHIT: 


A> GRAPHIT 

PLUTUAME-z 1.3GI COPYRIGHT (C) 1982 ENEKCOHP CO. 
DATA STORAGE AVAILABLE (NUMBERS): 8263 


It responds with a menu: 


•• GRAPH GENERATION •• 


ALL FUNCTIONS SHOW GRAPH AND OPTIONS ON SCREEN 

SELECTION FUNCTION 
NUMBER TO BE DONE 

1 X-T LINE GRAPHS 

2 BAM CHARTS 

3 CIRCLE CHARTS (PIE CHARTS) 

A EDIT GRAPH DATA 

5 BUILD GRAPH DATA FILE 

6 STOP THE PROCESS AND EXIT 

SELECT A FUNCTION (BY NUMBER) : 5 


After selecting option "S'*! some explanation appears: 


•• MAKING A NEW GRAPH/CHART DATA FILE 


THIS OPTION ALLOWS YOU TO MAKE A NEW DATA FILE, ON YOUR 
DISK, AND FILL THIS FILE WITH DATA FROM ANUTHEH DISK FILE 
OR FROM YOUR KEYBOARD - BY ENTERING IT MANUALLY. YOU MUST 
FIRST ENTER A FEW BASIC ITEMS REQUIRED FOR ALL DATA FILES. 

WHAT WILL BE THE NAME OF YOUR DATA FILE ON DISK? TESTF1LE.DAT 


here we choose the title: 


NOW ENTER A TITLE FOR YOUR DATA FILE (YOU CAN USE 

UP TO 20 CHARACTERS): This is the test case for the Manual Example. 
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Here we enter some verbage so future users will know about 
this data: 

NOW ENTEI ANY "NOTES" THAT YOU WISH TO INCLUDE IN THIS 
FILE AND WHICH HAY HE HELPFUL TO YOU IN THE FUTURE. 

Manual test case example data. 


Let's select our data type (we want an X-Y line graph): 

NOW ENTER THE TYPE OF DATA YOU WILL BE ENTERING. 

"1" FOR X-Y DATA. 

"2" FUR CHART DATA (PIE OR BAR WITHOUT COMPARISON BARS. 

"3” FOR BAR CHART DATA WITH 2 TO 9 BARS BEING COMPARED. 
TYPE: 1 


The system then responds with an explanation of the data 
editor: 


THE DATA MUST NOW BE ENTERED. THIS CAM HAPPEN IN TWO 
DIFFERENT WAYS. YOU CAN ENTER IT DIRECTLY, OR YOU CAN 
EXTRACT IT FROM A DISK FILE, THEN GO INTO THE "EDIT* 
OPTION AND hake ANY CHANGES NECESSARY. 

"1" TO ENTER IT MANUALLY. 

■2" TO EXTRACT DATA FROM DISK FIRST. 

METHOD:1 


We choose "method 1" 


YOU CAN NOW ENTER YOUR DATA WITH THE "A" OPTION OF THE EDIT ROUTINE. 
•* EDITING EXISTING GRAPH DATA •• 


THIS OPTION ALLOWS YOU TO EDIT GRAPH OR CHART DATA THAT 
HAS ALREADY BEEN CREATED. YOU EDIT THE DATA BY REFERRING 
TO THE "LIME NUMBER" OF THE DATA. THIS IS LISTED AT THE 
FAR LEFT COLUMN OF THE SCREEN. YOU HAY DELETE THAT LINE, 
INSERT ANOTHER LINE JUST BEFORE THAT LINE, OR REPLACE THAT 
LINE. ALL DATA IS ENTERED "FREE FORM* - THAT IS, SEPARATED 
BY COMMAS OH SPACES. ENTER "D" TO DELETE, "I* TO INSERT, 

OR "R* TO REPLACE DATA, FOLLOWED BY THE LINE NUMBER, E.G. 

D 123N 

WHICH WILL DELETE THE LINE NUMBERED * 123«l*. "oTHER OPTIONS: 
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"L" (line I) TO LIST THE DATA, (line #) TO PRINT THE 
DATA, "A" TO AUTO-INSERT DATA. NO NUMBER AFTER THE OPTION 
STARTS THE PROCESS WITH THE TITLE INFORMATION. WHEN FINISHED, 

A NULL ENTRY (RETURN KEY ONLY) WILL SAVE THE (NEW) DATA. 

ANY -OPTION ERROR- WILL RE-DISPLAY THIS EXPLANATION. 

As suggested, we choose the "auto" means to enter the data. 
Note upper case letters will be used in the system. Only the 
"A" is needed. 


ACTION:A 

PRESS -RETURN- KEl ONLY TO EXIT AUTO-INSERT MODE. 

AUTO-INSERT LINE# 1 

ENTER 2 NUMBERS: 1.23 3.RR 
2: 1.25 4.21 
3: T727l~Tr?7 
4: Tr?5T H5TF2 
5 : 172^6 575 
6: TTTr ~4T5~ 

7: 


Note that the long explanations occur only on the first 
entry. Subsequent entries are prompted only by the line 
number. 

Let’s list the data: 

ACTION; LIST 

DISK FILE NAME: ;TESTFILE.DAT, HAS 12 VALUES, 6 LINES:X - Y 

TITLE:This is the test cas 

NOTE:Manual test case example data. 

1 1.23000 3.44000 

2 1.25000 4.21000 

3 1.27100 4.97000 

4 1.28400 5.62000 

5 1.29600 5.60000 

6 1.31000 4.90000 


It seems that we left a couple of data elements out of the 
flle--between lines 1 and 2. Let’s Insert them. 


ACTION:!^ 2 

ENTER 2 NUMBERS:1.234 3.52 


The list confirms the action: 


DATA 
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ACTlONrL 

DISK FILE NAME: :TESTFILE.DAT, HAS 
TITLE:This is the test cas 
NOT£:Hanual test case example data. 

1 1.23000 a.^AOOO 

2 1.231100 3.52000 

3 1.25000 A.2 1000 

A 1.27100 A.97000 

5 1.28AOO 5.62000 

6 1.29600 5.60000 

7 1.31000 A .90000 


1 A VALUES, 7 LINES:X - Y DATA 


One sore tiee to feel secure: 

ACTION:A 3 

PKESS -HETUHN- KEY ONLY TO EXIT AUTO-INSEKT MODE. 

AUTO-INSEKT LINE# 3 
ENTER 2 NUMBERS:1.236 3.57 
A:1.2A1 A.02 

5.- 

It worked: 

ACTION: LIST 

9 LINES:X . Y DATA 

TiTLE:Thls is the test cas 
NOTE:Haaual test case eiaaple data. 


1 

1.23000 

3 .AAOOO 

2 

1.23A00 

3.52000 

3 

1.23600 

3.57000 

A 

1 . 2 A 100 

A .02000 

5 

1.25000 

A.21000 

6 

1.27100 

A.97000 

7 

1.28A00 

5.62000 

8 

1.29600 

5.60000 

9 

1.31000 

A .90000 


Can we insert data on the front of the file? (before line 
ACTION: AUTO J[ 

PRESS -RETURN- KEY ONLY TO EXIT AUTO-lNSERT MODE. 

AUTO-INSERT LINE# 1 
ENTER 2 NUMBERS: 1.21 3 .AI 
2:1.23 3.A77 
3: 
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It workf here also: 


ACTION: LIST 

DISK FILE NAME: :TESTFILE.DAT, HAS 22 VALUES, 11 LINES:X - Y DATA 

TITLE:Thl5 is the test cas 

NOTE:Manual test case exaapLe data. 


1 

1.21000 

3.41000 

2 

1.23000 

3.47700 

3 

1.23000 

3.44000 

<1 

1.23N00 

3.52000 

5 

1.23600 

3.57000 

6 

1.24100 

4.02000 

7 

1.25000 

4.21000 

8 

1.27100 

4.97000 

9 

1.28400 

5.62000 

10 

1.29600 

5.60000 

11 

1.31000 

4.90000 


How about insertion at the end of the file?: 
ACTlONiA 12 

PRESS ■RETURN" KEY ONLY TO EXIT AUTO-INSERT MODE. 
AUTO-INSERT LINE# 12 
ENTER 2 NUMBERS: 1.32 <1.83 
13:1.33 ‘1.67 
IN: 


Looks right here too: 

ACTION:L 

DISK FILE NAME: :TESTFILE.DAT, HAS 26 VALUES, 13 LINES:X - Y DATA 
TITLE:This is the test cas 


NOTE:Manual 

test case 

exaaple data 

1 

1.21000 

3.41000 

2 

1.23000 

3.47700 

3 

1.23000 

3.44000 

4 

1.23400 

3.52000 

5 

1.23600 

3.57000 

6 

1.24100 

4.02000 

7 

1.25000 

4.21000 

8 

1.27100 

4.97000 

9 

1.28400 

5.62000 

10 

1.29600 

5.60000 

11 

1.31000 

4.90000 

12 

1.32000 

4.83000 


It appears that line 2 was entered erroneously. Let's 
replace it with some proper data: 
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ACT10N:K 2 

EMTEM 2 NUMBERS: 1.22 3.*«3 


A list shows that it worked: 


ACT10N:L 

DISK FILE NAME: :TESTFILE.DAT, HAS 26 VALUES. 13 LINES:X 
TITLE:This is the test cas 
NUTE:MaauaI test case example data. 


1 

1.21000 

3.41000 

2 

1.22000 

3.43000 

3 

1.23000 

3.44000 

4 

1.23400 

3.52000 

6 

1.23600 

3.57000 

6 

1.24100 

4.02000 

7 

1.25000 

4.21000 

8 

1.27100 

4.97000 

9 

1.28400 

5.62000 

10 

1.29600 

5.60000 

11 

1.31000 

4.90000 

12 

1.32000 

4.83000 


Since line 5 is very similar to line 4, let's delete it, 
appearance sake, on the graph: 

ACT10N:D 5 


List it: 


ACTIOH:L 

DISK FILE NAME: :TESTFILE.DAT, HAS 24 VALUES, 12 LINES:X 
TITLE:This is the test cas 
NUTE:Hanual test case example data. 


1 

1.21000 

3.41000 

2 

1.22000 

3.43000 

3 

1.23000 

3.44000 

4 

1.23400 

3.52000 

5 

1.24100 

4.02000 

6 

1.25000 

4.21000 

7 

1.27100 

4.97000 

8 

1.28400 

5.62000 

9 

1.29600 

5.60000 

10 

1.31000 

4.90000 

11 

1.32000 

4.83000 

12 

1.33000 

4.67000 
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Before we save the file, let’s print it on the printer: 

ACTIOH; PHIMT 

HOW MAMY LIMES TO PHIMT: 999 

DISK FILE NAME: :TESTFILE.DAT, HAS 2A VALUES, 12 LIMES:X - t DATA 

TITLE:This is the test cas 

NOTE:Hanual test case ezaaple data. 

1 : 1.21000 3.41000 

2 : 1.22000 3-*13000 

3 : 1.23000 3-44000 

4: 1.23400 3-52000 

5: 1.24100 A.02000 

6 : 1.25000 4.21000 

7 : 1.27100 4.97000 

8 : 1.28400 5-62000 

9: 1.29600 5-60000 

10: 1.31000 4.90000 

11: 1.32000 4.83000 

12: 1.33000 4.67000 

To save it, first press ”return” only, then enter "S” or 
•’SAVE" (followed by "return"): 

ACT10M:_ 

EMTEH "SAVE" TO SAVE FILE, OM AMOTHEK ACTIOM KEQUEST: SAVE 


Now let's see what ttind of graph we get: 


A> GHAPHIT 

PLOTMARE-z 1.3GI COPYRIGHT (C) 1982 EMERCOHP CO. 
DATA STORAGE AVAILABLE (NUMBERS): 8263 


Now let's build a data file from another data file. An easy 
W 3 y to 1 * 3 K 6 your printed report^ whether it i? troni 
BASIC, PL1, or .... and direct its output to "SPOOLtb PKlNT" 
as the following list was done. An editor then extracted 
page 17 for our use. 

A>TYPE TlTAMlUh.DAT 

-TITANIUM SHIPMENTS “ PAGE 17 

Shipping Depot : AMSLOVILLE .WAREHOUSE 
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LINE f 1 

LINE « 2 

LINE 1 3 

LINE f 4 

LINE 1 5 

236 

341 

213 

298 

305 

2117 

347 

236 

259 

277 

2*15 

365 

209 

227 

323 

231 

349 

218 

240 

276 

215 

340 

235 

283 

307 

207 

360 

20b 

304 

302 

213 

358 

223 

279 

279 

229 

339 

232 

237 

323 

2ilA 

352 

204 

228 

274 

21(8 

364 

228 

262 

310 

237 

344 

227 

300 

300 

221 

343 

204 

296 

281 

208 

363 

232 

255 

322 

209 

354 

222 

226 

273 

222 

338 

206 

243 

312 

239 

357 

235 

286 

297 

248 

362 

217 

304 

283 

243 

341 

210 

276 

321 

227 

347 

237 

235 

272 

212 

365 

212 

229 

314 

207 

349 

214 

266 

295 

216 

340 

236 

301 

285 

233 

361 

208 

294 

320 

246 

358 

219 

252 

272 

247 

339 

234 

225 

316 

234 

352 

205 

246 

292 

217 

364 

225 

288 

287 

207 

344 

231 

303 

319 

211 

343 

204 

273 

272 

226 

364 

229 

233 

318 

After s 

electing "BUILD DATA..", 

and saying 

that it would 

an autonatic process 
and the decision for 

, we enter 
"bar chart 

a title, s 
data". 

hort descript] 


•• MAKING A NEW GKAPH/CHAHT DATA FILE *■ 


THIS OPTION ALLOWS YOU TO MAKE A NEW DATA FILE, ON YOUK 
DISK, AND FILL THIS FILE WITH DATA FROM ANOTHEH DISK FILE 
OR FROM YOUR KEYBOARD . BY ENTERING IT MANUALLY. YOU MUST 
FIRST ENTER A FEW BASIC ITEMS REQUIRED FOR ALL DATA FILES. 

WHAT WILL BE THE NAME OF YOUR DATA FILE ON DISK? TITANIUM.002 

NOW ENTER A TITLE FOR YOUR DATA FILE (YOU CAN USE 
UP TO 20 CHARACTEKS): TITANIUM, ANSLOVILLE 

NOW ENTER ANY "NOTES" THAT YOU WISH TO INCLUDE IN THIS 
FILE AMD WHICH MAY BE HELPFUL TO YOU IN THE FUTURE. 

SHIPMENT STUDY, ANSLOVILLE, FOR DAYS 7-11 LINES 1,2,3 AND 5 
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DAY SAMPLE 

JUNE 1 
JUNE 2 
JUNE 3 
JUNE A 
JUNE 5 
JUNE 6 
JUNE 7 
JUNE 8 • 
JUNE 9 
JUNE 10 
JUNE 11 
JUNE 12 
JUNE 13 
JUNE 1<i 
JUNE 15 
JUNE 16 
JUNE 17 
JUNE 18 
JUNE 19 
JUNE 20 
JUNE 21 
JUNE 22 
JUNE 23 
JUNE 2R 
JUNE 25 
JUNE 26 
JUNE 27 
JUNE 28 
JUNE 29 
JUNE 30 
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NOW ENTER THE TYPE OF DATA YOU WILL BE ENTERING. 

"1" FOR X - Y DATA. 

" 2 " FOR CHART DATA (PIE OR BAH WITHOUT COMPARISON BARS. 
"3« FOR BAR CHART DATA WITH 2 TO 9 BARS BEING COMPARED. 
TYPE; 3 

We will chart four bars, for line 1, 2, 3» and 5: 


NOW ENTER HOW MANY BARS WILL BE COMPARED ON YOUR CHARTijl 


The system requests 


"where will you get your data?": 


THE DATA MUST NOW BE ENTERED. THIS CAN HAPPEN IN TWO 
DIFFERENT HAYS. YOU CAN ENTER IT DIRECTLY, OR YOU CAN 
EXTRACT IT FROM A DISH FILE, THEN GO INTO THE "EDIT" 
OPTION AND HAKE ANY CHANGES NECESSARY. 

"1" TO ENTER IT MANUALLY. 

"2" TO EXTRACT DATA FROM DISK FIRST. 

METHOD;2 

ENTER THE NAME OF THE DISK FILE FROM WHICH THE DATA 
WILL BE EXTRACTED; TITAMIUH.DAT 


Examination of the printed report shows that seven lines of 
title information need to be skipped: 


YOU MAY "SKIP" SOME RECORDS AT THIS POINT. HOW MANY? 6 

••SKIPPED: TITANIUM SHIPMENTS PAGE 1? 

••SKIPPED; 

••SKIPPED; Shipping Depot : ANSLOVILLE WAREHOUSE 

• •SKIPPED; . ^ 

••SKIPPED; LINE I 1 LINE f 2 LIME f 3 LINE f 4 LINE I 5 
DAY sample 
••SKIPPED: 


For this case, all alphabetic data is beyond our M columns, 
so we will not discard any data: 

NOW THE DATA WILL BE EXTRACTED. IT IS EXPECTED TO BE 
IN "CULUHNS" IN THE DISK FILE. THESE ARE COLUMNS OF 
OF NUMBERS THAT ARE SEPARATED BY SPACES OR COMMAS. 

YOU MAY ALSO IGNORE A POSITION OR GROUP OF POSITIONS 
AS YOU EXTRACT THE DATA. THIS MUST BE SPECIFIED AS 
A BEGINNING CHARACTER POSITION, THROUGH AN ENDING 
CHARACTER POSITION (IN ORDER TO DISCARD "TRASH-) 

REVISION 1.4... (6-B3) 
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BEGIHMIIIG POSinOM (OH NOTHIMG. IF MOT UESIHED): 


The bar titles are taken Iron the date — here we say it is 
in position 70-72: 



YOUR DATA FILE MILL HAVE A COLUMNS OF DATA IN IT. 
THIS DATA FILE HAS DATA WHICH IS ALSO IN COLUMNS. 
YOU MUST MOW INDICATE HOW THE -COLUMN STRUCTURE- 
OF THIS DATA FILE WILL MATCH UP TO YOUR DATA FILE. 


YOUR BAR OR SEGMENT TITLE (UP TO 6 CHARACTERS) CAN BE 
TAKEN FROM ANYWHERE IN THIS FILE (AND LATER BLANKED). 
WHAT IS THE BEGINNING COLUMN OF THE TITLE? 7 A 


AMD THE ENDING COLUMN? 76 


We now let the system know that our data (for bars I 1, 2, 3 
and A) will be taken from columns 1, 2, 3, and 5* 

respectively: 


FOR COLUMN 1 Of YOUR DATA FILE, ENTER THE COLUMN 
NUMBER OF THIS DATA FILE WHICH WILL CORRESPOND: 1 

FOR COLUMN 2 OF YOUR DATA FILE, ENTER THE COLUMN 
NUMBER OF THIS DATA FILE WHICH WILL CORRESPOND: 2 

FOR COLUMN 3 OF YOUR DATA FILE, ENTER THE COLUMN 
NUMBER OF THIS DATA FILE WHICH WILL CORRESPOND: 3 

for column a OF YOUR DATA FILE, ENTER THE COLUMN 
NUMBER Of THIS DATA FILE WHICH WILL CORRESPOND: 5 


Here we will examine every record as it is presented and 
choose only the first five. 


YOU MAY PROCESS THIS DATA FILE IN ONE OF THREE WAYS TO 
EXTRACT YOUR DATA. 


A. 

B. 

C. 


PREVIEW EVERY RECORD BEFORE PROCESSING (ENTER -0-) 

PROCESS ALL REMAINING RECORDS IN THIS FILE (ENTER - 9999 ") 
PROCESS ONLY A CERTAIN NUMBER OF RECORDS (ENTER THAT NUMBER 


RESPOND: A 


••• NEXT RECORD ••• 

236 3A1 213 298 305 

JUNE 1 - ^ ^ 

ENTER «X« TO PROCESS, "N" TO NOT PROCESS, -S" TO STOP PROCESSING THIS WAY:N 


/ 
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••• NEXT RECOHD 

2«I7 347 236 259 277 

JUNE 2 

ENTER "Y" TO PROCESS, "N" TO NOT PROCESS, "S" TO STOP PROCESSING THIS NAY:H 
NEXT RECORD 

2^*5 365 209 227 323 

JUNE 3 

ENTER "Y" TO PROCESS, "N" TO NOT PROCESS, "S" TO STOP PROCESSING THIS HAY:j< 
••• NEXT RECORD 

231 3 N 9 218 2R0 276 

JUNE 4 

ENTER "Y" TO PROCESS, "N* TO NOT PROCESS, "S" TO STOP PROCESSING THIS WAY:^ 
NEXT RECORD 

215 3*»0 235 283 307 

JUNE 5 

ENTER "Y" TO PROCESS, "N" TO HOT PROCESS, -S" TO STOP PROCESSING THIS WAY:N 
NEXT RECORD »»• 

207 360 206 304 302 

JUNE 6 

ENTER "Y" TO PROCESS, "N" TO NOT PROCESS, "S" TO STOP PROCESSING THIS HAY:N 
••• NEXT RECORD 

213 358 223 279 279 

JUNE 7 

ENTER "Y" TO PROCESS, «N« TO NOT PROCESS, "S" TO STOP PROCESSING THIS NAY:Y 

1: 7 

1 : 213.00000 358.00000 223.00000 279.00000 

NEXT RECORD ••• 

229 339 232 237 323 

JUNE 8 

ENTER "Y* TO PROCESS, "N" TO NOT PROCESS, "S" TO STOP PROCESSING THIS WAYzY^ 


2: I 

2 : 229.00000 

NEXT RECORD ••• 
244 352 

JUNE 9 

ENTER TO PROCESS, 

«■ 

3 : m 


3 : I 244.00000 
NExf RECORD ••• 
248 I 364 

JUNEflO 

ENTER "r TO PROCESS, 


4: I 248.00000 
••• NEXT RECORD ••• 


339.00000 232.00000 323.00000 

204 228 274 

"N" TO NOT PROCESS, "S" TO STOP PROCESSING THIS HAY:Y 

352.00000 204.00000 274.00000 

228 262 310 

"H" TO NOT PROCESS, "S" TO STOP PROCESSING THIS NAYiY^ 


364.00000 228.00000 310.00000 
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237 3*»^ 227 300 300 

JUME 11 

EUTEH "Y" TO PROCESS, "H" TO NOT PROCESS, "S" TO STOP PROCESSING THIS WAY:Y 
5: 11 

5: 237.00000 

»• NEXT RECORD ••• 

221 3^3 

JUNE 12 

ENTER "Y* TO PROCESS, 

6: 12 

6 : 221.00000 

••• NEXT RECORD ••• 

208 363 

JUNE 13 

ENTER "Y" TO PROCESS, 

ENTER "Y" TO PROCESS MORE DATA FROM THE FILE, 

••B* TO GO BACK TO BEGINNING OF THIS FILE, 

■N* TO EDIT THIS DATA NOW:N 


After saying "N" to further extraction, we autoaiatically 
fall into the -EDIT MODE": 

Let's list the file before saving it, just to be sure: 


34R.00000 227.00000 300.00000 

204 296 281 

■N" TO NOT PROCESS, "S" TO STOP PROCESSING THIS WAY:Y^ 

343.00000 204.00000 281.00000 

232 255 322 

•N" TO NOT PROCESS, *S" TO STOP PROCESSING THIS WAY:S 


»• EDITING EXISTING GRAPH DATA •• 


THIS OPTION ALLOWS YOU TO EDIT GRAPH OR CHART DATA THAT 
HAS ALREADY BEEN CREATED. YOU EDIT THE DATA BY REFERRING 
TO THE "LINE NUMBER" OF THE DATA. THIS IS LISTED AT THE 
FAR LEFT COLUMN OF THE SCREEN. YOU MAY DELETE THAT LINE, 

INSERT ANOTHER LINE JUST BEFORE THAT LINE, OH REPLACE THAT 
LINE. ALL DATA IS ENTERED "FREE FORM" - THAT IS, SEPARATED 
BY COMMAS OR SPACES. ENTER "D" TO DELETE, "I" TO INSERT, 

OR "R" TO REPLACE DATA, FOLLOWED BY THE LINE NUMBER, E.G. 

0 1234 

WHICH HILL DELETE THE LINE NUMBERED "1234". OTHER OPTIONS: 

■L" (line #) TO LIST THE DATA, -P" (line i> TO PRINT THE 
DATA, "A" TO AUTO-INSERT DATA. NO NUMBER AFTER THE OPTION 
STARTS THE PROCESS WITH THE TITLE INFORMATION. WHEN FINISHED, 

NULL ENTRY (RETURN KEY ONLY) WILL SAVE THE (NEW) DATA. 

^NY "OPTION ERROR" WILL RE-DISPLAY THIS EXPLANATION. 

ACTION: LIST 

DISK FILE NAME: :T1TAN1UM.002, HAS 36 VALUES, 6 LINES:BAH CHART : COMPARE 
TITLE:TITANIUM, ANSLOVILLE 


* 
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MOTK:SHIPMENT STUDY, ANSLOVILLE, FOR DAYS 7-11 LIMES 1,2,3 AMD 5 


1: 

7 

213.00000 

358.00000 

223.00000 

279.00000 

2: 

8 

229.00000 

339.00000 

232.00000 

323.00000 

3: 

9 

244.00000 

352.00000 

204.000U0 

274.00000 

4: 

10 

248.00000 

364.00000 

228.00000 

310.00000 

5: 

11 

237.00000 

344.00000 

227.00000 

300.00000 

6: 

12 

221.00000 

343.00000 

204.00000 

281.00000 

ACTION 






ENTER 

■SAVE" 

TO SAVE FILE, OR 

ANOTHER ACTION 

REQUEST:SAVE 



Now let':; look at the chart: 

(SEE CHAHT AT END OF SECTION) 

Now for one more time, just to see two differences: 

1 ."BLANKlNG" out the data area (we will use the 6th column 
- the day - for our ■X") 

2. Heading an entire group of data (30 days worth) from a 
file for graph data editing. 


•• MAKING A NEW GKAPH/CHA8T DATA FILE •• 


THIS OPTION ALLOWS YOU TO MAKE A NEW DATA FILE, ON YOUR 
DISK, AND FILL THIS FILE WITH DATA FROM ANOTHER DISK FILE 
OR FROM YOUR KEYBOARD - BY ENTERING IT MANUALLY. YOU MUST 
FIRST ENTER A FEW BASIC ITEMS REQUIRED FOR ALL DATA FILES. 

WHAT WILL BE THE NAME OF YOUR DATA FILE ON DISK? TITANIUM.003 

NOW ENTER A TITLE FOR YOUR DATA FILE (YOU CAN USE 
UP TO 20 CHARACTERS): TITANIUM, ANSLOVILLE 

NOW ENTER ARY "NOTES* THAT YOU WISH TO INCLUDE IN THIS 
FILE AND WHICH MAY BE HELPFUL TO YOU IN THE FUTURE. 

INDIVIDUAL DATA FOR SHIPMENTS OF TITANIUM FOR LINE N 

NOW ENTER THE TYPE OF DATA YOU WILL BE ENTERING. 

■I" FOR X - Y DATA. 

"2* FOR CHART DATA (PIE OR BAR WITHOUT COMPARISON BARS. 

"3" FOR BAR CHART DATA WITH 2 TO 9 BARS BEING COMPARED. 

TYPE: 1 
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the data must how be emteked. this can 

xTlBrFIL“E!^?HrH CO INTO THE -EDIT- 
OPTIOH AND MAKE AMt CHANGES NtCESSAHt- 

-1- TO ENTER IT MANUALLl. 

-2" TO EXTRACT DATA FROM DISK FIRST. 

method:2 

ENTE. THE HAKE Of THE DISK^flLE f«OH -HICH THE DATA 
mill be extracted: titarium.dat 

,OU HAT -SKIP. HOHE HECO.DS AT THIS POINT. HOH HANTT 6 


TITAHIUH SHIPHENTS 
Shipping D«pot : ANSLOVILLE HAHEHOUSE 
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LINE « 2 


LINE « 3 


••SKIPPED: 

••SKIPPED: 

••SKIPPED: 

••SKIPPED: 

••SKIPPED: LINE # 1 

DAY SAMPLE 

••SKIPPED. cvtbaCTED it IS EXPECTED TO BE 

NOW THE DATA FILE THESE ARE COLUMNS OF 

IN -COLUMNS* IN THE DISK FILE. q,j COMMAS. 

OF NUMBERS THAT ARE qR^CROUP OF POSITIONS 

YOU MAY ALSO IGNORE A ^ITION ^“^"““^PecIFIED AS 
AS YOU E^'^J^JUJLeR^POSITIOR. THROUGH AN ENDING 
ShAH«?«"?oS (?« oIdEB t6 D1SCA.D -TBASH.) 

BEOINNINO position (ON NOTHING, IF NOT DESINED): 70 


LINE # <1 


LINE I 5 


ENDING POSITION : 73 


73 


Ks :su.?'s;k!s: 8.-r,;!:/sv.! ™ 

SS SM-"™ sH SS’ 

YOU MUST NOW “?^TCH np TO YOUR DATA FILE. 

OF THIS DATA FILE WILL MATCH UP lu 

SS!Ibh''w"t«sM?*‘e“”hh1cS’n!1I”?oI51espo1:1I="i 
YOU MAY PROCESS THIS DATA FILE IN ONE OF THREE WAYS TO 
EXTRACT YOUR DATA. 

PBEVIEH EVEBT «KOBD BEFOBE PBMEBSlNG^,(ENTEB^-0-)__^^^^.j 

“• ?.l:!:»T«IlmN nSSbeb OF,»ECONDS (ENTEB that NUHBEN) 
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KESPONU: 30 


1 : 

1.00000 

298.00000 

2 : 

2.00000 

259.00000 

3: 

3.00000 

227.00000 

4: 

4.00000 

240.00000 

5: 

5.00000 

283.00000 

6: 

6.00000 

304.00000 

7: 

7.00000 

279.00000 

8: 

8.00000 

237.00000 

9: 

9.00000 

228.00000 

10: 

10.00000 

262.00000 

11; 

11.00000 

300.00000 

12: 

12.00000 

296.00000 

13: 

13.00000 

255.00000 

14: 

14.00000 

226.00000 

15: 

15.00000 

243.00000 

16: 

16.00000 

286.00000 

17: 

17.00000 

304.00000 

18: 

18.00000 

276.00000 

19: 

19.00000 

235.00000 

20: 

20.00000 

229.00000 

21: 

21.00000 

266.00000 

22: 

22.00000 

301.00000 

23: 

23.00000 

294.00000 

24; 

24.00000 

252.00000 

25: 

25.00000 

225.00000 

26: 

26.00000 

246.00000 

27: 

27.00000 

288.00000 

28: 

28.00000 

303.00000 

29 : 

29.00000 

273.00000 

30 : 

30.00000 

233.00000 


ENTER •¥■ TO PROCESS MORE DATA FROH THE FILE, 

"B* TO GO BACK TO BEGINNING OF THIS FILE, 
•N» TO EDIT THIS DATA NOU:N 


•• EDITING EXISTING GRAPH DATA 


THIS OPTION ALLOWS YOU TO EDIT GRAPH OR CHART DATA THAT 
HAS ALREADY BEEN CREATED. YOU EDIT THE DATA BY REFERRING 
TO THE "LINE NUMBER" OF THE DATA. THIS IS LISTED AT THE 
FAR LEFT COLUMN OF THE SCREEN. YOU HAY DELETE THAT LINE, 
INSERT ANOTHER LINE JUST BEFORE THAT LINE, OH REPLACE THAT 
LINE. ALL DATA IS ENTERED "FREE FORM" - THAT IS, SEPARATED 
BY COMMAS OR SPACES. ENTER "D" TO DELETE, "I" TO INSERT, 

OR "R" TO REPLACE DATA, FOLLOWED BY THE LINE NUMBER, E.G. 

D 1234 

WHICH WILL DELETE THE LINE NUMBERED "1234"’. OTHER OPTIONS; 
■L" (line I) TO LIST THE DATA, "P" (line I) TO PRINT THE 
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DATA, -A* TO AUTO-IHSEKT DATA. MO MUMBEH AFTEH THE OPTION 
BTAMTS THE PROCESS WITH THE TITLE IMFORMATIOM. WHEN FINISHED, 
A NULL ENTRY (RETURN KEY ONLY) WILL SAVE THE (NEW) DATA. 

ANY ■OPTION ERROR" WILL RE-DISPLAY THIS EXPLANATION. 

ACTION:^ 

ENTER -SAVE* TO SAVE FILE, OR ANOTHER ACTION REQUEST:SAVE 


MAKING LINE GRAPHS 

In order to aake line graphs, the system presents a menu which 
can be filled out as needed. Only one item is needed. That is 
the title of a data file for the X and Y data values. It must 
have previously been created by the GHAPHIT system. You may 
enter up to 10 data files. 

All other information is for the sake of making a more 
professional appearance with the graph. The following items are 
available for these purposes: 

1. Three title lines across the top of the graph. 

2. Five sub-title lines which may be placed in one of the 

four corners of the graph. 

3< Titles for the X and Y axis. 

Each of these items may be entered or changed by first enterin'g 
the option number associated with it and then responding to the 
question asked by PLOTWARE-z. 

LINEAR and LOGARITHMIC plots. 

The system will graph both linear and log plots, in any 
combination. The type of plot is established during the AX15 
option, while the axis title is being specified. 

GRIDS on the plots. 

GRIDS may be placed on any plot in a variety of ways. The grid 
is always associated with the axis with which it is 
perpendicular, that is, the X axis grid will have vertical lines 
and the Y axis grid will have horizontal lines. The 
specifications about the vertical lines forming our grid will be 
established when you select the X axis options. The Y axis grid 
will be specified in the same manner. 

Each grid set must have specification for the kind of lines 
desired. If the line is on either end of the corresponding axis, 
the line will be solid (not dashed). The^other lines may be 
dashed if so desired. In addition to having dashed lines, a 
solid line may be established at regular intervals. if you 
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choose a dashed line, you must also specify the distance between 
dashes (which is also the actual length of one dash). 

^SCALING your data. 

The data presented to the X-Y graph routine does not have to 
reflect any special units. It must be consistent in some form, 
of course, to be validly displayed, although PLOTWAKE-z will 
graph trash Just as readily as it will graph your treasures. The 
system will SCALE your data to an appropriate set of values for 
the axis. It will always come up with a multiple of 10 or 2 or 5 
or something similar (or this value times a power of ten for 
large or small numbers) and display the data properly. If a 
power of ten is required in the scaling, the power of ten used 
will be added to your axis title in order to reflect the corres¬ 
ponding axis annotation used. 

For log scaling, a similar process occurs. The axis title will 
not reflect the units displayed. Instead, the units will be 
drawn between the annotations on the tic marks and the axis 
title, slightly larger than the annotaton letters and numbers, 
yet slightly smaller than the axis title. 

POSITIONING THE SUB-TITLE LINES 

The sub-title lines, as specified by option item *4 thru 8, may be 
placed at any one of four different locations on the graph. The 
location will probably be chosen based on the data which you 
display. The points at which this data may be placed are labeled 
on the small representation of the graph, on the menu, as "A**, 
"B**, "C, and "D". 

SAVING THE GKAPH 

The graph may be saved for later use in "composing", using 
electronic "cut and paste" techniques, or for later display and 
possible enhancement over that which has already been entered. 
This option is selected by the "SAVE" menu eqtry. The system 
will first ask for a file name to be used for saving the data. 
If you are going to use it for composing, be sure to use ".CMU" 
as the extension name, unless you plan to re-name it later. If 
you save it for a later plotting session, use any name you want. 

The "composing" version will be an ASCII file that can be readily 
editted. It will NOT have the first required command file entry 
(a PLOTS statement) or the last entry (an EXIT statement). This 
is to facilitate the merging of several of these files, if so 
desired. This option is selected by an "A" entry when requested 
by the computer. 

The version "saved for later plotting sessions" is a binary file 
whic holds certain data values and program overlay information 
which allows the GRAPHIT program to immediately begin right where 
you left off. This option is selected b")/ a "P" entry when re¬ 
quested by the computer. The process of re-starting it is as 
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follows: 

GHAPHIT filename.ext 

where filename.ext is the file name you choose when saving it. 
MAKING A GKAPH 

The X-Y line graph will be made on the appropriate device when 
this option is selected. Refer back to the chart. 

An example of using GHAPHIT to build an X-Y line graph: 


A>GHAPHIT 


•• GRAPH GENERATION •• 


ALL FUNCTIONS SHOW GRAPH AND OPTIONS ON SCREEN 


SELECTION FUNCTION 

NUMBER TO BE DONE 


1 X-Y LINE GRAPHS 

2 BAR CHARTS 

3 CIRCLE CHARTS (PIE CHARTS) 

A EDIT GRAPH DATA 

5 BUILD GRAPH DATA FILE 

6 STOP THE PROCESS AND EXIT 

SELECT A FUNCTION (BY NUMBER) : 1 


We select option 1 and get the X-Y line graph menu: 


ONLY ONE -GRAPH DATA- NAME IS REQUIRED, OTHER ITEMS ARE OPTIONAL. 


< 1 > 

< 2 > 

<3> 


-GRAPH DATA¬ 
FILE NAME 
TO USE 


<n> 


<A> 

<n> 

<5> 

< 6 > 

<7> 

< 8 > 

<B> 


<D> 


<C> 


TVST 


<BLANK> SPECIFY -GKAPH DATA- FILE NAME 
<1 - 3> CENTERED GRAPH TITLE 
<A - 8> -CORNER NOTATION- ON THE GRAPH 
<9> PLACE <A-8> AT <A>,<B>,<C>,<D> 
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<10> "X" TITLE, TYPE, GRID: 
<11> "Y« TITLE, TYPE, GRID: 
<12> HAKE THE GRAPH NOW. 

<13> SAVE THE GRAPH (BY NAME). 
<H> EXIT - ABANDON THIS GRAPH 


••CORNER NOTATION** NOW AT : A 
••X” AXIS IS LINEAR 
■Y* AXIS IS LINEAR 


We wish to graph the data file "TEST.DAT** so we press return: 


HAKE A SELECTION (BLANK, OR 1 THRU 1N):_ 

ENTER THE NAME FOK THE GRAPH DATA FILE (LINE I 1) 
TEST.DAT 


t 


ONLY ONE ••GRAPH DATA" NAME IS REQUIRED, 

< 1 > 

< 2 > 

<3> 


OTHER ITEMS ARE OPTIONAL. 

"GRAPH DATA¬ 
FILE NAME 
TO USE 


< 11 > 


<A> 

<‘l> 

<5> 

< 6 > 

<7> 

< 0 > 

<B> 


<D> 


<C> 


Tnj> 


<BLANK> SPECIFY "GRAPH DATA" FILE NAME 
<1 - 3> CENTERED GRAPH TITLE 
<A - 8> "CORNER NOTATION" ON THE GRAPH 
<9> PLACE <N-8> AT <A>,<B>,<C>,<D> 

<10> "X" TITLE, TYPE, GRID: 

<n> "Y" TITLE, TYPE, GRID: 

<12> MAKE THE GRAPH NOW. 

<13> SAVE THE GRAPH (BY NAME). 

<1R> EXIT - ABANDON THIS GRAPH 


TEST .DAT 


"CORNER NOTATION" NOW AT 
"X" AXIS IS LINEAR 
"Y" AXIS IS LINEAR 


A 


HAKE A SELECTION (BLANK, OR 1 THRU IN):11 


Notice that the file name is now present, after having been 
verified as present on disk by the system. There is still room 
for nine more data files to be plotted if we so choose: 


We select option 11, in order to specify a title for the Y axis. 
We also must tell what kind of Y data we have, so we indicate 
that it is linear. We also indicate that no grid is desired on 
this plot. 


ENTER THE TITLE FOB THE Y AXIS 
Y AXIS DATA 
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ENTER (FOR THIS AXIS ONLY) : 

1 TO PROVIDE LOGARITHMIC DATA DISPLAY 

2 TO PROVIDE LINEAR DATA DISPLAY («ITH GRID LINES) 

3 TO PROVIDE LOGARITHMIC DATA DISPLAY (WITH GRID LINES) 
<RETURM KEY> TO PROVIDE LINEAR (STANDARD) DATA DISPLAY : 


Notice that the menu reflects our choices up to now. we could 
continue to add more and more to the graph if we desire. 

ONLY ONE -GRAPH DATA" NAME IS REQUIRED, OTHER ITEMS ARE OPTIOMAL, 
<1> -GRAPH DATA- 

<2> FILE NAME 

<3> TO USE 


< 11 > 


<A> 

<*l> 

<5> 

< 6 > 

<7> 

< 8 > 

<B> 


<D> 


<C> 


-rT05 

<BLANK> SPECIFY -GRAPH DATA- FILE NAME 

<1 - 3> CENTERED GRAPH TITLE 

<4 . 8> -CORNER NOTATION- ON THE GRAPH 


<9> 

PLACE <4-8> AT 

<A>,<B>,<C>,<D> 

<10> 

-X- TITLE, TYPE 

, GRID: 

<11> 

-Y- TITLE, TYPE 

, GRID: Y AXIS 

<12> 

MAKE THE GRAPH 

NOW. 

<13> 

SAVE THE GRAPH 

(BY NAME). 

<14> 

EXIT - ABANDON 

THIS GRAPH 


TEST 


DAT 


-CORNER NOTATION- NOW AT 
-X- AXIS IS LINEAR 
-Y- AXIS IS LINEAR 


MAKE A SELECTION (BLANK, OR 1 THRU IDiJl 
Let's now make a graph: 


ON WHAT DEVICE IS THIS TO BE DRAWN? 

0 : DOT MATRIX PRINTER -TYPE A- (EC. MX80 DENSE MODE) 

1 : DOT MATRIX PRINTER -TYPE B" (EG. MX80 FAST MODE) 

2 : DOT MATRIX PRINTER -TYPE C- (EG.MXlOO DENSE MODE) 

3 ; DOT MATRIX PRINTER -TYPE D- (EG.MXlOO FAST MODE) 

4 ; PEN PLOTTER 

5 : GRAPHICS CRT 

6 : WORD PROCESSING PRINTER 

7 - 7 : SPECIAL DEVICE. ENTER SELECTION:2 


We choose item "2" as our output device (C.ITOH 8510 is used 
here): 

And we get this plot: 

(SEE CHART AT END OF SECTION) 
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BUILDING A BAR CHART 

A tutorial of this is not needed as it proceeds exactly as did 
the X-Y line graph. The following points are necessary, however, 
as they reflect differences or items of importance. 

BARS: 

a. Bats may be placed vertically or horizontally. 

b. Bars may be "STACKED" one on top of another. This is done 
by using two values on your input data file. After 
selecting the "STACKED" option, the 1st value is tne 
total value of the bat, the 2nd is the amount of the 
smaller (sub-bar). If the 2nd value is ZERO, no shading 
is done on the bar. USE THIS OPTION FOR INSTANCES WHERE 
YOU DO NOT DESIRE SHADING. 

c. Bars may be multiply stacked. Here you first choose 
"simple" bar charts. Then for each STACKED bar, the next 
data record MUST have a (hyphen) as its ONLY title. 
The value on this data record is the TOTAL height of the 
bat at that time. Continue as needed. Pot instance, we 
need 4 bars, each stacked 3 high: 

title amount 

8 

10 
13 
6 

12 
15 
9 

10 
11 
-4 
-9 
11 

Note that this will appear as 12 bars, but will actually be 
graphed as 4 bars, each with 3 elements. 

d. Bars may have negative values. When this happens, the 
reference axis is "floated" away from its annotation and 
title to allow room for the negative values to be 
plotted. 

e. Bars may be entirely negative. As in "d", the bar is 
"floated" to the highest (or furthest tight - depending 
on whether horizontal or vertical bats are used) point 
possible. 

BUILDING PIE CHARTS 


ITEM 1 

ITEM 2 

ITEM 3 

ITEM 4 
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A tutorial of this is not needed as it proceeds exactly as did 
the X-Y line graph. The following points are necessary, however, 
as they reflect differences or items of importance. 

SEGMENTS: 

a. To color a segment select the COLOR option. Use only the 
color available to your devices. 

b. To "explode" a segment (remove it slightly from the pie): 
Use a negative color (use -I for black on white, as with 
a dot matrix printer). 

SEGMENT ANNOTATION 

Annotation is centered in the segment, unless the segment is 
too small for this. 

Annotation outside of the segment is also angled to the 
center of the segment and is justified (either right or 
left) to the segment depending on the "direction" of the 
printing. 

DATA VALUES 

DATA VALUES may be any reasonable value. They will 
automatically be scaled to percentages. 


fl SAMPLE 

rut: 0(2 



(lAYS OF IHC MONTH : JUNE 
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EXPAHDING THE MENUS 


In using the DRAW command, one may soon desire to add new fea¬ 
tures to the menus which he finds in the DRAW module of the CHART 
processing program. This is always the case when one finds that 
certain "nice items" like logos, special sizes, special 
combinations of graphs, etc. will make his graphs assume a very 
-customized" appearance. This is usually approached by starting a 
major programming effort and spending many months of intense 
efforts building menus, file processing subroutines, and ail or 
the other typical things needed by a major system. 

The DRAW command is not implemented in that fashion, however. It 
instead will access a set of instructions ® 

specified in a very simple language that is a subset of the 
standard BASIC language ail computer users learn . . 

beginning of their experience with “ ^ ® 

particular language is so simple that a person who 
familiar with BASIC will be able to make new menus after a couple 
of hours of study in this section of the manual. 

BASIC does not have a convenient way to "format" data into 
an orderly appearance on the screen or in the disk files. This 
due mostly to the purpose of the original authors of BASIC, i 
would be a simple language for the SCIENTIST and ENGINEER who 
would usually scoff at frills in output appearance and who, 
instead, wanted his answers quickly. Consequently, 
implemented as the PLOTWARE-z language will use an extension to 
allow the proper formatting of the data to be passed to the 
PLOTWARE-z processing program. 


The subset of BASIC chosen for this purpose is called DATAWARE-z 
and will be referred to as this for the remainder of this manual. 
DATAWARE-x functions in the following manner: 


i. A DATAWARE-z file consisting of the BASIC statements is 
generated by some convenient word processing program or 
test editor just as any other text file would be generated. 
This file must be called : "DATAWARE.SRC . 


2. The INSTALL program is invoked and the ® 

COMPILER" is selected from the menu. This allows you to get 
a listing of the program along with any warning or error 
messages which may have been produced* 


3. 


The DATAWARE-z COMPILER will generate a code file called 
"DATAWARE.OAT". This file must be on the default disk when 
the DRAW verb is invoxed. It will then be accessed to 
present the included menus to the operator of PLOTWARE-z. 


The file DATAWARB.SRC, as used in the distribution disk, may be 
obtained from the INSTALL program as a selection from its menu. 


SYNTAX OP DATAWARE-X 
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VERBS AVAILABLE IN DATAWARE-z: 

ACCEPT - Get an item from a screen structure. 

ASC - Convert a numeric item to a character item. 

CLOSE - Used to terminate access of a disk file or data base. 
ENTRY - Marks the location the DATAwARE-z program begins. 

FIELD - Used to define a data item. 

FOR n « m TO mm - Used to define and control loops. 

GET - Used to access a data base item. 

GOPROG - Initiates separate program - with return privelege. 
GOSUB - Transfers control to external subroutine. 

GOTO - Used to transfer control to a new location (label) 

IF - Used to selectively transter control to a label. 

INPUT - Get data from the operator console. 

INPUTIn - Get data from a file or another user partition. 

NEXT - Used to terminate a loop and/or continue its action. 
OPEN - Used to begin access of a disk file or data base. 

PRINT - Used to display items on the operator console. 

PRlNTIn - Used to display items into disk files or partitions. 
PUT - Used to insert an item into a data base. 

RETURN - Transfers control back to the host program. 

SCREEN - Defines a screen to be used for data entry. 

SELECT - Repositions data base pointer (as applicable). 

VAL - Converts character data item to numeric. 

Other syntax items: 

assignment statement: 

VARIABLE « STATEMENT 

label: 

nnn 


PROGRAM STRUCTURE: 

The DATAWARE-z program is different from BASIC programs because 
it roust always specify any fields which are used in the program. 
This is in keeping with the stated purpose of making FORMATTING 
of the data simpler. Ail "variables" used in the program must 
therefore be declared by a FIELD statements (which may occur 
anywhere in the program}# by a SCREEN statement and its 
accompanying variable declarations (at the beginning of a 
DATAWARB-z program) or by implicit reference to a data base item 
through the OPEN statement. 

The OATAWARE-z program cannot have multiple statements on a 
single line# separated by the ":"# as allowed by some BASIC 
interpreters, but it can have multiple statements on separate 
lines. This means that it is NOT NECESSARY that each line have a 
statement number. In fact, it is recommended that only the lines 
be numbered which are specifically teference'd by a IF or a GOTO 
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Statement, as this speeds the execution and as only 255 labels 
ace allowed in a program. 

Arithmetic statements are allowed only in ASSIGNMENT statements 
and may not be used in other ways. If an arithmetic statement is 
needed, in an IP statement for example, the assignment statement 
should precede the other statement to perform the arithmetic 
procedure. The resulting quantity can then be used as a 
"variable". 

Variables are specifically given a type by their respective 
defining verbs. String variables are specifically given a length 
and that length is always constant. Variables may not be 
REOEPINEO by the encounter of another conflicting statement. 

All other differences are seen as one of the two following items: 

a. Since OATAWARE-z is a subset of BASIC, some extensions of 
some of the verbs may be omitted. 

b. OATAMARE-z has Specific verbs associated with external 
multiple tasks, data base structures, and CRT screen con¬ 
cepts. Therefore certain verbs are found in DATAWARE-z that 
are not in BASIC. 

SYNTAX OP THE OATAWARE-Z VERBS: 

ACCEPT 

Syntax: 

ACCEPT variable 

This causes the cursor to position itself at the screen position 
defined by the SCREEN statement(s) and begin to assemble the item 
referenced by the variable name. The variable name must be 
specified by the SCREEN statement as one of the variables of the 
screen. 

EXAMPLE : ACCEPT NAMED1 

ASC 

Syntax; 

ASC variable 

This effects the conversion of a numeric item (specified by the 
variable) into a character (string) item. This is normally used 
to transfer numeric quantities, which would normally be 
unreadable in a "standard ASCII* data format into a format of 
that type. It affects the TOGGLE variable in the following way: 

TOGGLE • 0 when a normal conversion occurs. 

TOGGLE* 1 when a conversion occurred with overflow ofthe 
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EXAMPLE 


receiving field. 

OATEOl * ASC (DATBX) 


CLOSE 

Syntax: 

CLOSE n (standard file format) 

CLOSE name (data base format) 

This closes an input disk file. It closes and saves an output 
disk file, with any updates noted in the directory. It must 
specifically be executed for any output disk file which you wish 
to save for other uses. It terminates usage of a data base file 
and allows other tasks and/or programs to access the updated file 
structures (as applicable). 

EXAMPLES: CLOSE 2 CLOSE "MXDATA.DBS" 

ENTRY 

Syntax: 

ENTRY n 

DATAWARE>*z functions as a "subroutine* to other software 
structures. The normal use of OATAWARE-z allows the program to 
"call" the dataware structure and to direct it to begin at a 
specific point. DATAWARE-z may choose to assemble certain data 
and then return to the calling program to allow it to process 
that data. On subsequent times, the host program may then return 
to DATAWARE-z in the same way, but with the intention of 
proceeding from a different point. This point is specifically 
stated by the ENTRY statemnt. 

This statement is not normally used unless the complexity of the 
calling structure and/or the needs of the host program require 
it. 

EXAMPLE: ENTRY 3102 


FIELD 

Syntax: 

FIELD n variable defaultvalue format 
Where: 

*n* is 0 for the pass/return array to the host program. 

"n" is 1-5 for disk files, or n = 6 for* the data base. 

"variable" is a well-defined variable"name, not previously 
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encountered. 

*defaultvalue" is a default value that the variable assumes. 
This is a convenient way to specify "CONSTANTS". 

"format* specifies the beginning location in the respective 
file or area where the variable begins. It is followed by a 
dash and another number indicating that the field extends 
through that position. This is true only on character 
(string) variables and only the beginning position is needed 
for integers and reals. 

This allows the program to subsequently use that name as a 
variable, as specified. The following convention is used when the 
"format* character option is omitted (hence specifying a NUMERIC 
item): 

If the variable begins with I,J,K,L,M, or N it is an INTEGER 
Otherwise it is a REAL 

Caution should be exercised with the use of integers and reals as 
most "canned software* accepts only character (string) data. The 
usual place where Integers and reals are found is in the 
pass/return array for use by the host program, or for use as 
"scratch-pad* items, or in disk files where speed and data 
compaction is necessary. Integers and reals are stored in the 
standard "mainframe* format of two bytes per integer and four 
bytes per real. 

EXAMPLE : FIELD 2,MYINTG,45,(15) 

HYINTG is an integer in file 2, occupying 2 bytes 
of memory. It begins with a value of 45. 

FIELD 3,MYSTRG,*A0Cdefl23456*,(21-32) 

NYSTRG is a character (string) variable occupying 
positions 21 through 32 of the area of file 3. It 
has an initial value of *ABCdefl23456”. 

PROGRAMMING HINT: Since it is rare to need all five possible 
files during a DATAWARE-z data entry subroutine, it is usually 
convenient to select one of the files (for example 15) to use as 
a "work* or "scratchpad* area. The work variables will then 
always occupy that file's area. 

FOR 

Syntax: 

FOR n « m TO mm 

This allows "loops* in the standard sense of BASIC programming. 
It sets the variable "n" to the quantity "m" and procedds through 
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the loop until it encounters a "NEXT* statement. It then 
increments the quantity "n" by 1 and begins the next trip through 
the loop if the quantity "n" is not greater than "mm". Hence it 
always makes one trip through the loop no matter what values "m" 
and "mm" assume. 

The variables "n", "ra", and "mm" must be assigned as integers and 
referenced as such throughout the "program". 

EXAMPLE: 

FIELD 5,N,0,(10) 

FIELD 5,M,12,(12) 

FIELD 5,MM,20,(14) 

FOR N » M TO MM (loops from 12 through 20) 

GET 

Syntax: 

GET data-base-specification. 

This is used to obtain the item specified in the target data 
base. The section accompanying the data base of your choice must 
be consulted to reference the proper syntax for this verb. 

GOTO 

Syntax: 

GOTO n 

The label "n" must exist in the program and must be in the proper 
✓ range for a label 

EXAMPLE: GOTO 100 


Syntax: 

IF variable-1 Itest variable-1 THEN n 

"variable" is a properly formed variable and both are 
compatible in type. 

"Itest" is one of the following: 

m 

h 


REVISION 1.4 


(6-83) 

d 









■n" is a valid label. 


This allows the progra* to make logical program 


transfers. 

EXAMPLE: 

INPPOT 


control 


IF A » a THEN 200 


Syntax: 


INPUT 

INPUTin 


(input from the console) 

(from a disk file or user partition) 


This does not get variables from the designated location. It 
RECORD from the location, which will, or course, 
contain the values to be associated with the variables. It then 
the responsibility of the FIELD statements to get the values to 
rMpitr' variables. It Is suggested lhat one use the 

Single variables only as this simplifies the 
direct console items. If the console is to accept 
* time, probably following the 
Single question to the user, the best way to 
accomplish this is to use the SCREEN verb to set up a CRT screen 


EXAMPLE: 


INPUTI2 (gets next record from file 2) 
INPUTI3(IKEy) (RANDOM FORM : record IKEX) 


NEXT 


Syntax: 

NEXT 

HlTcV. the loop 

loIL- provision in DATAWARE-z to handle "nested 

constructs^^*^* BASIC. Care should be taken to avoid these 

OPEN 

Syntax: 


OPEN n 

OPEN "DATABASE.NAM' 


(data file format) 
(data base format) 


subsequent usage via 

usage depends on the data base attached. 
See the appropriate section for your preferred data base. 

The proper action for data files is as follows; 
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a. For established sequential files, the next references 
should be INPOTIn only. 

b. For new files (output files), the first reference will 
cause any established file to be removed. 

c. For random files, the first access of the file must be an 
INPUTIn. Thereafter reads and writes may be interspersed. 

It should be noted that there is no inherent record limit in 
DATAWARE -2 as there is in BASIC and other systems. If you wish to 
write or read a 750 character record, you may do so. There is a 
realistic limit however, as imposed by the total memory on your 
system. If this is exceeded by abnormally large file sizes, you 
nay possibly experience a system halt with an accompanying 
message about the resultant lack of memory space. 

EXAMPLE: OPEN 3 "B:DATAPILE.DAT" (OPENS FILE 3 as 

DATAFILE.DAT on "B:") 


PRINT 

Syntax: 

PrIMT (Console format) 

PRINTin (DISK FILE or DATA BASE format) 

This allows the display of the designated fields onto the 
appropriate item. This is the only way to effect a physical 
transfer of the data which you have specified through the use of 
your FIELD statements. A record of length equal to that necessary 
to handle all of your specified fields will be transferred to the 
designated place. The values of 1-5 are valid for disk files. The 
value of 6 may be valid for your data base. See the data base 
section appropriate to your preferred data base format. 

EXAMPLE: PRINTI3 


POT 

Syntax: 

PUT variable 

This allows the direct entry of a data base item into the 
specified location. See the section on your preferred data base. 

RETURN 

Syntax: 

RETURN 

This construct allows the return of control to the host program. 
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In PLOrWARE-z, it should be used only aftec the file "COMMON.CrtO" 
and the appcopciate data £ile(s) have been gathered. This is the 
proper way to begin processing the data gathered by the DATAWARE- 
z subroutine and the command file built during that process. 

SCREEN 

Syntax: 

SCREEN 

(records ; 'one for each line to display on the CRT) 

FIELD 


This allows an easy way to specify a CRT screen to be built. The 
necessary "help" information and room for each input field 
(denoted by the underline symbol(s)) precedes, then a FIELD 
statement for each field follows. There is one major difference 
between this FIELD statement and the standard FIELD statement. 
There is no "format" part as each field is necessarily character 
data (do not attempt to enter binary data on an ASCII terminal!) 
and the position of input is already defined. The total length of 
the screen input field is the sum of the separate fields within 
the SCREEN. 

EXAMPLE : 

SCREEN 
Tour NAME 
your SSN 
The DATE 
FIELD 0,NAMEIN," 

FIELD 0,SSNIN," 

FIELD 0,DATEIN," 

This defines a three line screen with three fields. The total 
record length is the sum lengths of the fields. When displayed on 
the screen, the first two fields will be blank and the DATE field 
will have dashes in the proper positions for month, day, and year 
placement. 

SELECT 

This construct allows the proper placement of the input-output 
process for certain data base constructs. It effects a specified 
record and file selection as necessary. See the section on your 
preferred data base. 


Syntax: 

VAL(variable) 
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This is the means to convert character (string) data into numeric 
format. It sets the TOGGLE variable as follows; 

TOGGLE » 0 (after successful conversion) 

TOGGLE* 1 (after conversion on non-numet ic data) 

This allows the editing of numeric data fields. 

EXAMPLE; X - VAL (MTSTRG) 

This construct# like the ASC construct# is valid only in the 
assignment statement. 

label 

There is provision for labels in the program. The label must 
occur as the first item on that program line, and must be in the 
range of 1 to 255 (inclusive) 

EXAMPLE; 40 X * A + B 

This shows a label used together with an assignment statement, 
assignment statement 

This allows the inclusion of simple computations. Since 
DATAWARE-z is designed for data input and not computations# the 
assignment statement is limited to the following forms: 

variablel ■ variable2 arithop variable! or 

variablel * function ( variable2) 

arithop may be ; •+■#"“"#"***"/"fOC . . 

The second form is seen with VAL and ASC operations (see above). 
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USING THE COMMAND PILE SYSTEM - OPERATING DETAILS 

When using the command file system, it is assumed that the usee 
is familiar with the following items: 

a. The COMMAND PILE language. 

b. The INSTALLATION of his HARDWARE. 

c. Any items unique to his system (device TYPE, etc.) 

If you have not done these, return to the proper sections and do 
so. This section is designed to provide any specific details 
necessary to the operation of the system which were not covered 
in those other sections. However, this section will be complex 
and vague to those not familiar to some degree with the above 
items. 

OPERATION: 

The COMMAND FILE system revolves around three different files. 
These must always be accessible to the system when running: 

a. CHART.COM 

b. PLOTSPBC.DAT 

c. OVERLAYS.OVR 

CHART is the base program which processes the command files. It 
is started by the operator or by the running system (see the 
BASIC example in the INTERFACE section for an example of this) 
and will not be needed again. 

Chart is not in the format of the usual PASCAL, COMPILED BASIC, 
FORERAN, or similar object code files. It instead consists of 
many linked assembly language modules which contain many 
different data and object code areas. These areas may be or may 
not be modified in the process of running the system. Some of 
these areas are specifically scrambled to facilitate the security 
system of PLOTWARE-z. However, the program CHART.COM will not be 
modified in any way once it is loaded. Therefore, it may be 
STARTED, by the operator or by any system, from any disk desired. 
This will allow the user to manage his disk storage facilities in 
whatever manner is convenient to the occasion. Instead, all 
modified code and overlay code and data that is modified will be 
placed into the file PLOTSPBC.DAT and/or PLOTWARE.OVR. Generally 
speaking, one must never perform input or output to PLOTSPBC.DAT 
for that file is for the internal usage of PLOTWARE-z routines. 
The file PLOTWARE.OVR may be used as a link and chain file (see 
the INTERFACE SECTION) and can be freely modified in the first 8 
logical (128 byte) records. The format of the first 12 bytes of 
the first record is fixed (see the INTERFACE SECTION), and 
records beyond the first eight records wiU. most likely be 
modified if they are included into this file. If 1012 bytes of 
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common disk storage is not enough for your program requirements 
outside of the COMMAND FILE routines, use another disk file and 
maintain it in some acceptable fashion. 

The CHART program first reads the PLOTSPEC.DAT file and analyses 
this file with respect to the code file in memory (CHART.COM). If 
the code file matches that expected from the serialized 
distribution disk, as expected via a special serial number “hatch 
algorithm", the program proceeds. The first 262 bytes of memory 
are always used for this purpose. This is called the "initialize 
phase". Other things proceed during this phase: 

a. The handling of "3 pass" dot matrix color printers. 

b. The handling of "n pass* single pen plotters. 

c. The establishing of further "serial number hatch and 
slash* routines. These always occur periodically and will 
use the first 262 bytes of memory, obtain their code 
from the OVERLAYS.OVR file and access PLOTSPEC.DAT to 
find necessary overlay space for long routines. 

d. The structure of the OVERLAY SKELETON for the CHART 
program. 

It should be noted that the overlay structure of PLOTWARE-z is 
not like that used in BASICS and PASCAL compilers found 
elsewhere. It is specifically designed to be a multi-level 
overlay scheme and must not be modified by the user. Modification 
of the .OVR files or of the file PLOTSPEC.DAT will probably 
result in a "systems crash* and the user may find that the disk 
directories will be destroyed. LEAVE THESE FILES ALONE! If you 
are overly concerned about this problem occurring - perhaps by 
the inadvertent encounter of Murphy's Law while you are debugging 
some external program (those assembly language programs will be 
candidates for this sort of thing), feel free to use STAT to make 
these file READ-ONLY. PLOTWARE-z is sufficiently intelligent to 
modify the status of the file(s) prior to writing to them in the 
overlay process. 


SUMMARY OP DISK FILES 

GRAPHIT.COM (menu driven graphics) - Uses CHART.COM 

CRT's, Plotters: 

a. GRAPHIT.COM (on default disk) 

b. OVBRLAYG.OVR (may be placed on any disk - prefer default) 

c. CHART.COM (on default disk) 

d. OVERLAYS.OVR (may be placed on any disk - prefer default) 

e. PLOTSPEC.DAT (on default disk) 

DOT MATRIX PRINTERS; 
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a. GRAPHIT.COM 

b. OVERLAYG.OVR 

c. CHART.CON 

d. OVERLAYS.OVR 

e. PRINTMAP.COM 

f. PLOrSPEC.DAT 


(on default disk) 

(nay be placed on any disk -* prefec default) 


(on default disk) 

(nay be placed on any 
(on default disk) 

(on default disk) 


disk - prefer default) 


CHART.COM (for COMMAND FILE plotting without GRAPHIT, or by 

the USER program as written) 


CRT's, Plotters: 


a. CHART.COM 

b, OVERLAYS.OVR 
C. PLOTSPEC.DAT 


(on default disk) 

(may be placed on any disk - prefer default) 
(on default disk) 


DOT MATRIX PRINTERS: 


a. CHART.COM 

b. OVERLAYS.OVR 

c. PRINTMAP.COM 

d. PLOTSPEC.DAT 


(on default disk) 
(may be placed on 
(on default disk) 
(on default disk) 


any disk - prefer default) 


PRINTMAP.COM (used atomatically for others - for dot matrix) 


Reference files: 

a. PLOTWARB.DAT (holds last "picture" from any program) 

(required) 

b. PLOTWARE.OVR (holds return overlay information for auto¬ 

restart of calling (chaining) program. Pro¬ 
gram name in 1st record, pos 2-12.) restarts 
only if this file is present. 

PLOTCOMP.COM (Used to generate binary file of plotter routines.) 
(This routine is found in the INSTALL section. Use INSTALL to run 
it from the INSTALL overlay structure - level 3) 

1. PLOTSPEC.SRC (the input file to the compiler PLOTCOMP) 

2. PLOTSPEC.DAT (the output file from the compiler) 
MODIPY.COM 


files as indicated in menu : during execution. 

This part of the INSTALL program allows the specific direction of 
certain parameters to the PLOTSPEC.DAT file and to the CHART.COM 
overlay structure. This is the way one must select specific 
options for multiple oot matrix printers or multiple dot matrix 
printer modes. 

YOU DO NOT NEED THE PLOTCOMP AND MODIFY SECTIONS PAST 
INSTALLATION. Remove these once the system is installed. 
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When using compiler library file system, it is assumed that the 
user is familiar with the following items: 

a. The language to be used as a "host program" language. 

b. The INSTALLATION of his HARDWARE. 

c. Any items unique to his system (device TYPE, etc.) 

d. The "linking process" associated with the host language. 

If you have not done these, return to the proper sections or 
documents from your language vendor and do so. This section is 
designed to provide any specific details necessary to the opera¬ 
tion of the system which were not covered in those other 
sections. However, this section will be complex and vague to 
those not familiar to some degree with the above items. 

OPERATION: 

The COMPILER LIBRARY system revolves around three different files. 
These must always be accessible to the system when running: 

a. The USER PROGRAM. 

b. PLOTSPEC.DAT 

c. OVERLAYS.OVR 

The USER PROGRAM is the base program which processes the graphic 
command subroutines. It is started by the operator or by some 
running system which can intelligently select control of the 
computer to some other program. The necessary code overlays and 
data overlays will be taken from available memory of the computer 
after the program performs its first mandatory call to the PLOT- 
WARB-z system (via a call to PLOTS) and the original code file 
will not be needed again. 

The PLOTWARE-z routines which require overlay of program and/or 
data structures are not in the format of the usual PASCAL, COM¬ 
PILED BASIC, FORTRAN, or similar object code files. Therefore, it 
will not interfere with any of these types of overlay calls. It 
instead consists of many linked assembly language modules which 
contain many different data and object code areas. These areas 
may be or may not be modified in the process of running the 
system. Some of these areas are specifically scrambled to facili¬ 
tate the security system of PLOTWARE-z. However, the program 
users program on the disk will not be modified in any way once it 
is loaded. Therefore, it may be STARTED, by the operator or by 
any system, from any disk desired. This will allow the user to 
manage his disk storage facilities in whatever manner is 
convenient to the occasion. Instead, all modified code and over¬ 
lay code and data which is modified will be placed into the file 
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PLOTSPBC.DAT and/oc PLOTWARE.OVR. Generally speaking, one roust 
never perform input or output to PLOTSPBC.DAT for that file is 
for the internal usage of PLOTWARE-z routines. The file 
PLOTWARE.OVR may be used as a link and chain file (see the 
INTERFACE SECTION) and can be freely modified in the first 8 
logical (128 byte) records. The format of the first 12 bytes of 
the first record is fixed (see the INTERFACE SECTION), and 
records beyond the first eight records will most likely be 
modified if they are included into this file. If 1012 bytes of 
common disk storage is not enough for your program requirements, 
use another disk file and maintain it in some acceptable fashion. 

The user program will call PLOTS which will first read the 
PLOTSPBC.DAT file and analyse this file with respect to the code 
file in memory (linked PLOTWARE-z parts only). If the code file 
matches that expected from the serialized distribution disk, as 
expected via a special serial number "hatch algorithm", the 
program proceeds. The first 262 bytes of memory are always used 
for this purpose. This is called the "initialize phase". Other 
things proceed during this phase: 

a. The handling of "3 pass" dot matrix color printers. 

b. The handling of "n pass" single pen plotters. 

c. The establishing of further "serial number hatch and 
slash" routines. These always occur periodically and will 
use the first 262 bytes of memory, obtain their code 
fromt the OVERLAYS.OVR file and access PLOTSPBC.DAT to 
find necessary overlay space for long routines. 

d. The structure of the OVERLAY SKELETON for the CHART 
program. 

Be sure to always allow this "low memory" area in your user 
programs. See the INTERFACE SECTION for an example of this in 
FORTRAN. 

It should be noted that the overlay structure of PLOTWARE-z is 
not like that used in BASICS and PASCAL compilers found 
elsewhere. It is specifically designed to be a multi-level 
overlay scheme and must not be modified by the user. Modification 
of the .OVR files or of the file PLOTSPBC.DAT will probably 
result in a "systems crash" and the user may find that the disk 
directories will be destroyed. LEAVE THESE FILES ALONE! If you 
are overly concerned about this problem occurring - perhaps by 
the inadvertent encounter of Murphy’s Law while you ate debugging 
some external program (those assembly language programs will be 
candidates for this sort of thing), feel free to use STAT to make 
these file READ-ONLY. PLOTWARE-z is sufficiently intelligent to 
modify the status of the file(8) prior to writing to them in the 
overlay process. 
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SUMMARY OF DISK FILES - COMPILER LIBRARY “RUN TIME" 


CRT“^ Plotters; 


a. User's program (on any disk) 

b. PLOTSPEC.DAT (on default disk) 


DOT MATRIX PRINTERS; 

c. PRINTMAP.COM (on default disk) 

d. PLOTSPEC.DAT (on default disk) 

PRINTMAP.COM (used atomatically for others - for dot matrix) 
Reference files; 


a. PLOTWARE.DAT (holds last "picture" from any program) 

(required) 

b. PLOTWARE.OVR (holds return overlay information for auto¬ 

restart of calling (chaining) program. Pro¬ 
gram name in 1st record, pos 2-12.) restarts 
only if this file is present. 


PLOTCOMP.COM (Used to generate binary file of plotter routines.) 
(This routine is found in the INSTALL section. Use INSTALL to run 
it from the INSTALL overlay structure - level 3) 


1. PLOTSPEC.SRC (the input file to the compiler PLOTCOMP) 

2. PLOTSPEC.DAT (the output file from the compiler) 


MODIFY.COM 


files as indicated in menu : during execution. 

This part of the INSTALL program allows the specific direction of 
certain parameters to the PLOTSPEC.DAT file and to the CHART.COM 
overlay structure. This is the way one must select specific 
options for multiple dot matrix printers or multiple dot matrix 
printer modes. 

YOU DO NOT NEED THE PLOTCOMP AND MODIFY SECTIONS PAST 
INSTALLATION. Remove these once the system is installed. 
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OBVICB SPBCIFICATIOH - Real Tine Devices 

In attaching new devices, the usee roust be aware of the sirople 
language of PLOTCOMP. This is processed by a part of the INSTALL 
program and will produce the necessary code to drive the 
plotters, CRT's, cameras, and such which are typically assigned 
to graphics peripheral service. 

Host items do not need assembly language support, but if you do 
need it or just prefer to use this approach, it is available. The 
code must reside from 14SH and cannot extend past 200H. See the 
SUBR command and the CALL command. 

MODIPTIHG TBB PLOTtiARB PARAMBTBRS 

The PLOTWARB-z software can be modified in all of the areas which 
specify the hardware to be used as graphics output. These areas 
are held in “COMMON" storage, in most cases and are accessible 
via the COMMON specification in either M80 assembler, or by the 
COMMON specification in F80 Fortran, or similar compilers. In the 
case of any standalone programs which access these variables, a 
separate program, “MODIFif.COM“ (found as structure “1“ of the 
INSTALL program) will change these parameters to the desired 
values. Some changes are able to be made only by external pro¬ 
gram means, such as DOT.COM, but these are all associated with 
such things as replacing an assembler driver routine and are not 
generally used. Other modifications are possible through the 
INSTALL program. 

The explanation of each of these variables follows, with the 
variables grouped into the following categories: 

1. Pen plotter and word processing printer parameters. 

Includes discussion of the plotter command parameters. 

2. Dot Matrix printer parameters for plot generation - as 
common with the REAL TIME device data areas. 

3. Device "driver" addresses - used for placing user - 

installed routines for other hardware devices. 

The parameters are described in the following fashion: 

PARAMETER NAME (variable NAME in common) 

PARAMETER description. 

When using the COMMON specification, it should be noted that all 
parameters MUST be of the proper type and usage. For this rea¬ 
son, all parameters named in common follow this convention: 

All REAL variables ace named with a beginning letter of A-H or O- 
Z. 

All 16 bit integers are named with a beginning letter of I-K or 
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M-N. 


AH 8 bit integers ere ne.ed eith . beginning letter of L. 
parentheles"need\“|peciffe| <>"»y the name used in 

the MODIFY program. ^ will be accounted for by 

PEN PLOTTER end WORD PROCESSING PRINTER pereeeters. 

STEP SIZE OP PLOTTER (STEPS) 

The step size of the plotter cr 

each step of the controlleffective distance between' 
expressed in -steps per i„oh- end .unW®’ “““elly 

software in this fashion if ■'’® metered into the 

fractional value (e.g. .005) take expressed in a 

default step size is 200 0 - th» ^.®f^*'® ”»t“e. The 

S.ven b, the Houston IhBt'’ru“.ent/X!ot*LViV. Vlortefs' 

the multiplicative factor for X VALUES (XFACT) 

for*%n; ;tr''eng“e* s“tep siz*." tS;t'‘“tthl°be‘'^''“ eoftwere 

-the X step size -ay be only 1/2 th^ encountered, for instance 
Since there is only one stpp size of the Y step size 

value by a factor of 2 in ord« to'avoid““*i '“eight- each x’ 

in his plot. ‘’®' avoid a -squashed- appearance 

the MULTIPLICATIVE FACTOR FOR y VALUES (XFACT) 

functions* e°a^Vly‘’«'’i;JjCT*does*l«‘J?%alue“^ 
the maximum number of X steps PER PLOT COMMAND (MAXXS) 

the plot based“Vn an* aYg«Uhm''\h1rt*‘inc*l''d Points of 

2n5y*'’S“^L^*e^i7or^h“Vv*e‘''anJ*M"“t*C'*“^ 

nu.bet of X steps which U «n ta”e wltr: ‘® '^'’® 

the plotter, in the case of worn d single command to 

usually 1 Since the pr?nt« »us? Ptlnters, this is 

the pen- is down, it say be limited ^®®#.®i. Ptint a period, if 
plotter. It is set to ^999 ii ^ electronics of your 

•smart- controller " the Hl’pLOT p^o^terT""" 

the maximum number of , steps per plot command (maxxs, 

«a‘ct4* a*s"«s*‘M'';Srxs!"’ "*“"“" ‘''® * “"Pe- H functions 

the -^EPS / inch- for boro processing plotters (WPXSTP) 

The word processing printers must calculate-, ee 

calculate a conversion for each 
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-plotter move- in terms of their available ®^ 

distance that the platen moves the paper in the line feed or 
reverse line feed mode is called WPXSTP. This is delivered 
the standard system as 48.0. 

THE "STEPS / INCH" FOR WORD PROCESSING PLOTTERS (NPYSTP) 

This is a corresponding value for the movement ot the daisy wheel 
or thimble across the page. It is standard as 60.0. 

THE TABLE OF "PSEUDO COMMANDS" (LPTABL) 

This is the relative number for the 

COMMANDS. It exists in the machine as f For 

each olotter type must be contained in 512 bytes 
example, the H^PLOT series of intelligent 

COMPLOT series is 1, and so on. The specifica- 

rained by the relative call numbers found in the PLOTa 

tionf in the standard system, this table se^fs 

parameters - the HIPLOT series (intelligent), the COMPLOT 

(DMP 4,5,6). and the QUME word processing printer. 

See the explanation at the end of this section 

planation on the LPTABL and how to write new code tables for it. 

DOT MATRIX PRINTER PARAMETERS common with the REAL TIME area. 

The dot matrix printers supported by ^he standacd «e all 

controlled by a set of parameter tables that define the necessary 

protocol for obtaining graphics on P'g"^®/oi*„hich 

of these devices have several forms of graphics, some 
are "dense", and gives a good approximation to a pen plotter 
are oense , ^ ara oivina quicker results 

graphics; and some of which are tast , gi ^ .ug 

since the dots ate printed farther apart. The density 
dufeceot -Sdes give else to foot sets pt 'Vo(t.a» 

the dot matrix commands. If the user is changing 

fSt another printer which has only one fe^s “/spe'^lfi 

he need change only one of the types of ^ 

that corresponding "PRINTER CALL" when he is using the device. 

The PRINTER graphics are made in the following way: 

1 Por the TYPE 1,2 and 3 mode, the print head maxes one pass 
icro.s the page and puts all of the dots Into place. No overlap 
of dots occurs, and the individual dots can be seen. 

2. for the TYPE 0 mode, the first pass Pfhu"oart 
density and each adjacent dot overlaps the previous d t Y P 

of a do^t. The head then returns and begins the ^hetween 

first advances just enough to Pa« the eeto"\ row^ of ^dots^bet 

Sarf'’rdo‘t.“’ii;ir?e'su^°ts-in^^” better resolution in this dlrec- 
tion. 

3. For the TYPE 2 mode, tne first pass proceeds as did the 
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previous mode, however, there is no second pass made by the 
print head. This is done in order to allow a "medium dense 
mode*. This gives less resolution than is available with the 
previous mode, yet it is still very good resolution. This mode 
is especially useful for those tasks which may take longer than 
you need, yet which still require very good resolution. 

The parameters are explained as follows: 

THE NUMBER OP STEPS/INCH, PAPER TRAVEL DIRECTION (XlFACT) 

This describes the number of "dots / inch" that will be placed 
onto the paper, in the paper travel direction. This is a func¬ 
tion of the distance between the matrix wires in the print head, 
and can be doubled if the print head can make two passes across 
the line, offsetting the second pass so as to print the second 
row of dots between the first row. This value here reflects the 
density when NO second pass is made. In the standard system, this 
is 72.0. 

THE NUMBER OP STEPS/INCH, PAPER TRAVEL DIRECTION (X2PACT) 

This describes the density when TWO print head passes are made. 
In the standard system, this is 144.0. 

THE NUMBER OP STEPS/INCH, "ACROSS" THE PAGE (YIPACT) 

This is a corresponding value for the "across the page" density. 
It reflects the dots per inch, when the head is traveling at the 
"normal* rate of speed. It is 60.0 in the standard system. 

THE NUMBER OP STEPS / INCH, "ACROSS" THE PAGE (Y2PACT) 

This is a corresponding value for the "across the page" density 
when the print head is traveling at maximum resolution, or is 
printing (plotting) in the "compressed* mode. It is 120.0 in the 
standard system. 

THE EPPECTIVE WIDTH OP THE PRINT PATH OP THE PRINT HEAD 

This number reflects the print width of the print head pass, from 
its extreme "left" to its extreme "right*. It is used to alio-* 
cate storage for the vector to raster scan conversion and to 
produce an effective "window" for all plotting to be done on your 
device. It is 8.0 in the standard system. 

THE EPPECTIVE WIDTH OP THE PRINT PATH OP THE PRINT HEAD 

This number reflects the print width of the print head pass. It 
is intentionally set at 15.0 (wider than the actual travel of the 
wide printers) so that future printers may be included. It is of 
no real concern, for most printers will throw away the extra 
values. 

THE MAXIMUM LENGTH OP THE PICTURE IN THE X DIRECTION 
(XLDFLT) 
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This value reflects the roaxinum length of the page for the 
picture to be drawn on the dot natrix printer. It is set at 10.0 
for the standard system, and is adjustable (dynamically) for each 
picture, by use of the XYSIZE statement. This value is the 
DEFAULT value only, and remains dynamically available through the 
xySIZE statement after it is installed. 

SPECIAL NOTE ON THE "X" AND "y" SIZE SPECIFICATIONS. It should be 
noted that these are DEFAULT values only, and ate easily changed 
with the xySIZE statement. If you ate continually tunning 15 
inch by 15 feet - long plots of petroleum log data, or something 
similar, this option allows you the liberty of specifying that 
size - which may be "standard* for you - to be the default size 
of each plot. 

ENABLE THE "OPTIMIZATION" MODE OF THE EPSON DRIVER (ISTAT) 

This "feature" is for use only on EPSON printers. 

There is a feature in the EPSON microware, located in the print¬ 
ers own controller, and hence not readily accessible by the user, 
which allows data to be occasionally lost if the plot data is 
presented to the printer at the proper (or in this case, impro¬ 
per) time. The PLOTWARE-z routines have an algorithm which will 
negate this "feature" and this routine must be used if you are 
using a buffered serial card in your EPSON. This card has the 
nasty habit of accepting data from the line and presenting this ^ 
data to the printer in "spurts" which will most definitely cause 
this "loss of data* feature to be invoiced. If your printer is on 
either an unbuffered serial card (of which there are several 
available, and which must be decided upon by the user for his 
particular unit) or on a parallel port of your computer, you can 
realize a significant increase in throughput by enabling this 
option. It must be 0 to be enabled. It is set to 1 (disabled) 
in the standard system. 

(OPTIMIZING MODE ONLY) PRINTER PORT I.O. (LPORT) 

This is for EPSON printers only. 

This specifies the port of the computer which is used to sense 
the "busy* or "not busy" status of the printer device. It is 
delivered as 043H in the standard system (the printer status port 
of the major I/O processor card of the ENERCOMP TWIN-Z system). 

(OPTIMIZING MODE ONLY) PRINTER STATUS MASK (LBIT) 

This is for EPSON printers only. 

This specifies the bit mask of the status port to use, in order 
to examine only the bits pertinent to the printer. The standard 
system is set to 1, meaning bit 0 is the status of the print 
device itself (not the I/O processor card ilself). 


REVISION 1.4 


(6-83) 






PLOTWARE-Z 


DEVICE SPECIFICATION SECTION 


page:H-6 


(OPTIMIZING MODE ONLY) HI/LO MASK BIT. (LAN02) 

This is foe EPSON printers only. 

This specifies whether the LBIT mask looks for a "high" or a 
"low" status mask. If this is the same mask as the LBIT varia~ 
ble, the mask is looking for a "low" or zero result of the mask. 
If the value is zero (regardless of the value of LBIT)# the mask 
is looking for a "high" or non-zero result of the mask test. It 
is set to 1 in the standard system (high means "busy", low means 
"not busy" - ready to accept data). 

(OPTIMIZING MODE ONLY) STATUS STABLE TIME (ISWAIT) 

This is for EPSON printers only. 

This is used to calculate the "stable status" time of the EPSON 
printer. It is set to 100, which is adequate for a 6 MHZ or 4 
MHZ processor (or the 5 MHZ 8085, often referred to as a 10 MHZ 
processor, by virtue of its external clock). It should be 
halved, if an 8080 or 2MH2 Z80 processor is used. This is a 
relatively non—critical value, as it can be "too large" without 
resulting in any significant degradation of the plotting process. 

DEVICE DRIVER ADDRESSES 

The remaining parts must be modified by the user, and are availa¬ 
ble for those printers or platters which must be attached through 
an external routine. These are the critical entry points of the 
PLOTWARE-z system, and are to be used for assembler level (or the 
like) modifications. 

EPSNMAP.COM (vector to raster scan conversion) 

THE ENTRY POINT TO THE LIST DRIVER ( 014BH ) 

This is the point to which the software branches to output a line 
of plot data. The register convention is as follows: 

HL - points to the byte array to be output. 

DE - points to the number of bytes to output. THIS MAY 
BE ZERO - handle it properly. 16 bit integer. 

BC - points to the maximum for this line - may indicate 
an error condition if less than the 16 bit integer 
pointed to by DB. 


LAST BYTE OF LIST DRIVER ROUTINE ( 0150H) 

Used to limit the user routine from expanding into other core of 
other routines. 
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These ace not generally needed by the usee, but if it is 
necessary to write assembly language routines, these give the 
necessary "hooks" to get to the proper places. DO NOT PLACE CODE. 
OUTSIDE OF THESE BOUNDARIES. 

MAXIMUM BIT (print wire) TO ADDRESS (014AH ) 

Set to 128 for the standard system (bit 7). It can be less, if 
fewer wires than 8 ace calculated at any one pass. For example, 
this would be 32 (bit 5) for the early PAPER TIGER printer which 
uses only six wires on its graphic pass. 

PEN PLOTTING AND WORD PROCESSING PLOTTING 

PLOTTING PRIMITIVE DRIVER ROUTINE 

This routine is used to provide the plotting for the system when 
using the pen plotting routines. It is a standard routine that 
can interpret the "pseudo code" of the LPTABL array and interface 
just about any plotting device to the system. This routine 
should serve any reasonable plotting device which can be encoun¬ 
tered. If you choose to write your own routine, you will find 
the device entry point to be "ZXPLOT", if linking to the system, 
and the address (in stand-alone programs) will be pointed to by 
location 0145H. The last address of the routine will be pointed 
to by 0i47H. No register convention is used in the call. The 
data passed is through the COMMON statement and appears in com¬ 
piled form at the end of this section. 

Ill 11 I NOTE OF CAUTION I I I I I I I 

There ace several "things" built into the plotting software which 
are designed to protect the proprietary nature of the software. 
These are keys to several different items, including the serial 
f number embedded in several different places in the code, the 

copyright notice included in the front of the software, and 
certain checksum factors strung throughout the code. This is to 
also insure the integrity of the software - in order to catch any 
possible disk failures as well. If you get any "undocumented 
error message, this is probably because you made a coding error. 
Be very careful in this, as some errors, when found by the check¬ 
ing software, will attempt to overwrite your disk directory with 
garbage - in order to destroy what appears to be a pirated soft¬ 
ware product. 


COMPILING A NEW PEN PLOTTER INTO THE SOFTWARE with PLOTCOMP 

The program PLOTCOMP accepts the file PLOTSPEC.SRC and processes 
this into a new code file to drive the plotting devices. It 
should be noted that the plotting software requires positions 0 
thru 3 to be allocated to four different types of dot matrix 
printer-plotters. These ate usually the MX70/80 and MXlOO from 
EPSON. There can then be an unlimited Jin a logical sense) 
number of plotters appended to the software by building a code 
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file foe each plotter. The first plotter is indexed as number 4 
and is known by default as HIPLOT. Other plotters, including the 
word processing printers, high performance industrial plotters 
and the like are referenced by the TYPE command in the PLOTS call 
(TYPE 5, 6, ...) or explicitly by number in the calling programs 
that may be linked to the software. 

The program PLOTCOMP.COM builds a set of "code" which is inter¬ 
preted by a virtual routine loaded at execution time. This 
interpreter will accept this code and dessiminate the data to 
what ever device it is routed to. It expects the code to provide 
several routines which will be executed as they are requested 
from the software. These routines, referred to as "modules", are 
listed by index. They must be presented to the compiler in 
order, by this index order. 

Module 0 - Initializes the device for plotting 

Module 1 - Oe-implements the device for plotting 

Module 2 - Instructs the "pen" to drop to the surface. 

This may be an "IDLE" or "RETURN" command only if the pen 
instructon is handled by the movement modules. 

Module 3 - Raises the "pen". 

Module 4 - Directs the plotting movement in the "north 
east" direction, in relation to the present pen location. 

The top of the plotting surface is referenced as "north". 

Module 5 - 11 - Directs the movement to East, SB, SOUTH, 

SN, WEST, NW, and North respectively. 

Module 12 - Directs the device to provide an "inter - 
plot" pause. This could be an operator message, or a 
screen copy and erase (as on the Tektronics tubes) or any 
other such action desirable. 

Module 13 - N (up to maximum memory capacity of 512 bytes). 
Allows the individual control of the pens. The first 
module is for pen 1, and so on. If there is any necessary 
pen manipulation in the device at startup, this should be 
done in the initialize routine, as the software does not 
execute an implicit call to PEN t 1. 

FORMAT OF THE CODE ARRAY PROM PLOTCOMP 

The code array that is produced from the compiler is organized 
into 2 groups. The first 16 bytes specify the STEP, XFACT, 
YPACT, MAXXS and MAXYS to the software. It should be noted that 
these are dynamically specified by the PLOTCOMP routine and any 
"hard wired" parameters put into the machine with the modifica¬ 
tion routine will be overwritten when a call to PLOTS is made for 
the standard routines. The next 496 byt^s are allocated to 
driving the plotter with the following "primitive" commands. 
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Each comnand that allocates memory requites one byte for the 
command and one byte for each parameter. The commands are num¬ 
bered beginning with 0, extending up through whatever is the top 
command number - each is listed. 


The parameters can be decimal numbers, or negative decimal num¬ 
bers. There is a small array of memory to which the negative 
decimal numbers refer. These are available for use in the con¬ 
version of the internal (binary) X and Y and PEN numbers or 
commands into different formats. The reference is as follows: 


-1 : the sign of the last converted decimal item 

-2 through -6 : the decimal number last converted 
from X or T. 


-2 through -4 : 
(in 5 bit code. 


the COMPLOT number just converted 
with the (maximum) 3 characters. 


-2 through -6 : the TEKTRONIX number just converted 
with the ENHANCED (4096 x 4096) graphics included. 


-7 The last converted decimal pen number 

-7 The result of the last PENDOWNUP operation executed. 

The operations may also reference literal strings (enclosed in 
quotes) for the PUNCH, DISPLAY, and LIST commands. This allows 
the easy transfer of string data to these devices. This is 
specifically excluded from the OUTPUT command, as there will 
probably be a combination of INPUT and other commands (such as 
WAITMS) which are used to support direct port devices. 

PRIMITIVE COOES for PLOTTING MODULES 


MECHANICAL - Required for each plotter specification. This 
has three parameters - the STEPS, XFACT, and YPACT 
parameters. Entered in INTEGER or REAL format. Must be 
first item for a plotter specification. 

PLOTTER - Required. Three parameters supply the MAXXS, the 
MAXYS, and the PLOTTER INDEX code. Must be second item for 
each specification. 

PUNCH- Routes items to the CP/M output port commonly 
referred to as REAOER/PUNCH, and usually used to supply 
modem support, second printer support, etc. One parameter 
- may be integer, negative integer, or literal string. 

DISPLAY - Functions as PUNCH, except routes to the operator 
console. 

LIST- Functions as PUNCH, except routes to the CP/M list 
device. 
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OUTPUT - Functions as PUNCH, except routes to a specified 
port code (parameter 1) the code or b/te referenced by a 
negative integer (parameter 2). No literals available. 

SENSE-* used to support direct port manipulation. Reads 
the port specified by parameter 1, ANOS it with the byte 
specified by parameter 2, XORS this result with parameter 3 
and continues this until a zero result is obtained. 

Example : PORT : 43 "busy bit" : 2 "busy is HIGH" 

SENSE 67 4 4 

The 67 is decimal for 43H. The 4 is the byte represented 
bit 2 "on". The third parameter duplicates parameter 2 
because "busy is HIGH" when ready for the next byte. 

Example ; PORT ; 50 "busy bit" : 7 "busy is LOW" 

SENSE 90 128 0 

WAIT- Allows the program to wait a multiple of 500 
microseconds. Parameter 1 specifies how many 500 
microsecond periods to wait. 

CONVERTXlOA- Converts absolute X position to the -2 
through -6 memory locations. 

CONVERTTlOA - Converts the absolute Y. 

CONVERTXIOR - Converts the relative X. 

CONVERTYIOR - Converts the relative Y. 

CONVERTXCPS - Converts the X to COMPLOT format. This takes 
the fifteen bit integer (negative is o.k.) and breaks it 
into 3 segments of 5 bits each. It then adds each segment 
to 20H and stores it 

CONVERTYCPS - Convert the Y in CPS format. 

CONVERTER- Converts the X and Y to the enhanced TEKTRONIX 
format used in the tektronix machines. It should be noted 
that this will drive the machines WITHOUT enhanced graphics 
as well, as they are upward compatible. The COLOR 
TEKTRONIX 4027 and 4113, etc. can use either this format or 
a far simpler, direct format. 

READER- Accepts a byte from the CP/M READER device and 
test it for PARAMETER 1. If not, equal, it repeats. If 
parameter 1 is 255, it accepts any character. 

INPUT - Functions as READER, except reads port specified by 
parameter 1 and tests based on parameter 2. 
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KEYBOARD- Functions as READER, except used operator 
console input. 

PENOOrtNUP- If the pen is presently specified as DONN, 
places parameter 1 into the -7 location for subsuqueut 
routing. If pen is UP, places parameter 2 into -7. 

CALL- Loads HL with the address of the internal conver¬ 
sion area (-1 through -7) and calls the location specified 
by parameter 1 and parameter 2 (in inverted format). 

MICR0500 - Respecifies the WAIT period for the WAIT 
routine. Based on cycles through the routine; 


WAITR: DEC D 

JP NZ,WAITR 

IDLE- Effects a NOOP - can be used to provide multiple 
entry points into a common routine. 

RETURN - Returns control to the plotting software. Must be 
used to end each routine (module). 

SUBR- This allows the user to load a subroutine into the 
“transient" area. This extends from 145H to 200H. Only 127 
bytes may be loaded at any given time. If more room is 
needed, several subroutines may be executed in turn. 


CALL- This allows the user to call the (previously 
entered) subroutine. It must reference the location in 
inverted byte sequence and be entered as (two) decimal 
quantities. 


There is no example section to this part as the entire code 
structure, in totality or in part, is available through the 
INSTALL procedure. This generates the file PLOTSPEC.SRC which 
contains these types of codes. It also will compile this file 
(either after you have generated it by INSTALL or after you have 
entered and/or modified it by a text editor) and generate the 
associated PLOTSPEC.DAT file. Be sure to always re-install your 
dot matrix printer options into the file after compiling it, as 
each PLOTCOMP run will re-instate the DEFAULT parameters. 
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This section covers items unique to deferred devices such as dot 
matrix printers. It is intended to serve as a guide to those 
needing to modify the operation of PLOTMARE-z in these sections. 
Do not proceed into this section until you have read the previous 
section. Much of the code common to this section and the previous 
section is explained there - and not here. 

The INSTALL program will usually install whatever items are 
needed to specify a printer. It does this by the following 
manner: 

a. Most printers and other devices will need some sort of 
sequence to specify "GRAPHIVS MODE". This is a ONE-TIME 
initialization phase. 

b. Some printers may need to have each line preceeded by a 
special "line-intialization” sequence. 

c. Some printers may need to nave each line terminated by a 
special "line termination" sequence. 

d. Some printers may need each byte to be Inverted to allow for 
the different ways that a data byte is to be presented to the 
printer(s). 

e. Some printers may need the data length of that line presented 
to them in some fashion. The more popular types are included in 
the standard set of instructions. 

f. Some printers need each data byte to be ”OR-ed" to assure that 
certain bits are on in each data item. 

These items are all controlled by a set of "control bytes" placed 
into the PLOTSPBC.OAT file at INSTALL time. These are automatic 
for direct printer type selection, and may be specifically, 
entered for other printers. Run the INSTALL program and proceed 
through the necessary prompts to accomplish this. 
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OPeRATING and INSTALLATION INFORMATION 
This section is intended to covet any items not specifically 
covered in other sections. It is necessary to read this section 
only if the other sections did not cover your specific operation 
questions. 

The PLOTWARE -2 system is distributed on diskettes with many 
different pieces of software. The diskette has very little room 
for any work files and should be copied onto more usable media 
before doing any graphics work. The original diskette then 
should be filed away for back-up use in the future, and for 
obtaining new releases of the software. 

COMPILER SUPPORT FILES 

The "compiler" support software consists of a file called 
"PLOTLI8.REL". This file holds all of the routines for all of 
the attachment options in a relocatable format for MICROSOFT 
compilers. It is written in an 8085 code assembler format, and 
will operate with any 8080, 8085, or 280 system, provided that 
you have the MICROSOFT support programs needed to link these to 
your FORTRAN, COBOL, or BASIC programs. 

The routines may be included in your overall system library by 
use of the routine LIB on your MICROSOFT diskette. This will 
result in a larger library for all of your programs and will 
require some extra time during the link phase. If the majority 
of the programs you use are non-graphics oriented, the library 
should be left as a separate file or put onto a diskette for 
usage only with graphics systems. 

To build an "integerated" support library with your current 
MICROSOFT library, use the following method; 

1. RENAME your library: 

REN FORLI8X.REL»FORLIB.REL 

2. MAKE THE NEW LIBRARY: 


FORLIB«EPSNPLOT,FORLIBX 
/E 

The above sequence will build a new (FORTRAN) library and pre¬ 
serve your old library as FORLIBX.REL. 

To compile and execute your program, the following sequence would 
be used: 

F80 -MYPROG 

L80 MYPROG,MYPROG/N/e 

MYPROG 

This is the same sequence that would have always been used. To 
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use the library without integrating it into the MICROSOFT li¬ 
brary, the following procedure would be used: 

F80 «MyPROG 

L80 MYPROG,EPSNPLOT/S,FORLIB/S,MYPROG/N/E 
MY PROG 

This would perform the same sequence. 

COMMAND FILE or INTERACTIVE PROGRAMS 

The standalone programs (which also support the COMMAND FILE 
format), are called 

CHART.COM and 
OVERLAYS.OVR and 

GRAPHIT.COM and (if you choose to use this) 

OVERLAYG.OVR and (if GRAPHIT is included) 

PLOrSPEC.DAT 

on the distribution diskette. 


DOT MATRIX PRINTERS - the PRINTMAP printers. 

The dot matrix printers have a built in graphics support feature 
known as OKIGRAP or GRAPTRAX or something similar which allows 
the placement o£ about 10,000 to 30,000 dots to the inch on dot 
matrix printers. This gives an extremely dense and very good 
approximation to the lines drawn at any angle that the program 
desires. As a comparison, this resolution - with the APPLE 
"high-resolution* graphics as a comparison device - would give 
the same "density* in a square about l.S inches by 1.5 inches at 
10,000 dots per inch. A better way to mentally compare this 
would be to imagine the APPLE sceen reduced to this size : it 
becomes obvious how the "blocky" appearance of the typical 
consumer computer will become very insignificant on this scale. 

This feature creates some problems with the computer, however, 
because the obvious solution to the vector to raster conversion - 
the computation of a very large matrix - either in core or on 
disk - becomes very unwieldy long before any decent graphics 
appear. The data base mapping techniques take out this problem 
however, and pick up another problem as this one is solved. If 
you generate an 8 inch by 10 inch picture on the dot matrix 
printer with the "dense* option, the software needs to transfer 
bits to generate a matrix containing 1,300,000 elements (1.3 
million - this is not a typo, error). Hence many times more bytes 
need to be transferred in the GRAPHICS mode than in the normal 
printing mode. It is suggested that the user obtain the fastest 
method available to his system to run the printer. The fastest is 
usually called a "parallel" or "Centronics" interface. If a 
serial interface is used, some slow operation may be experienced 
if the baud rate is very slow. For instance, on the C.ITOH 
PROwRITER 2, at 160 dots per inch, about 2500 bytes need to be 
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passed to the printer per "scan line" pass in the densest mode. 
This amount of data is quite a bit more than is passed to print 
just 132 columns! If at all possible, use a parallel interface to 
maintain the speed of the system. 


There are several interfaces which cannot reliably operate at the 
higher speeds necessary to promote maximum speed printer speeds. 
The "high speed serial buffer" from OKIOAT and the "SERIAL BUFFER 
ADAPTER" from EPSON are most notable in this manner. If you 
experience erratic operation on these devices, try a slower baud 
rate or contact your printer distributor for a "microcode fix*. 

SUMMARY OF DISK FILES 


GRAPHIT.COM 


(menu driven graphics) 


CRT’s, Plotters; 


a. GRAPHIT.COM 

b. OVERLAYG.OVR 

c. CHART,COM 

d. OVERLAYS.OVR 

e. PLOTSPEC.DAT 


(on default disk) 
(may be placed on 
(on default disk) 
(may be placed on 
(on default disk) 


any disk - prefer default) 
any disk - prefer default) 


DOT MATRIX PRINTERS: 


a. GRAPHIT.COM 

b. OVERLAYG.OVR 

c. CHART.COM 

d. OVERLAYS.OVR 

e. PRINTMAP.COM 

f. PLOTSPEC.DAT 


(on default disk) 
(may be placed on 
(on default disk) 
(may be placed on 
(on default disk) 
(on default disk) 


any disk - prefer default) 
any disk - prefer default) 


CHART.COM (for COMMAND FILE plotting) 


CRT"s, Plotters: 


a. CHART.COM 

b. OVERLAYS.OVR 
C. PLOTSPEC.DAT 


(on default disk) 

(may be placed on any disk - prefer default) 
(on default disk) 


DOT MATRIX PRINTERS; 


a. CHART.COM 

b. OVERLAYS.OVR 

c. PRINTMAP.COM 

d. PLOTSPEC.DAT 


(on default disk) 
(may be placed on 
(on default disk) 
(on default disk) 


any disk - prefer default) 


PR1NTMAP.COM (used automatically for others - for dot matrix) 
Reference files: 

a. PLOTWARE.DAT (holds last "picture* from any program) 

(required) 

b. PLOTWARE.OVR (holds return overlay information for auto¬ 

restart of calling (chaining) program. 
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This section gives a description of tne 

tunction. Most modules are accessible in one ot the two syntax 
forms listed below. 

1 Your module may be accessible through the syntax used for 
standard FORTRAN calls, or other MICROSOFT compi e J 
programs, or others with compatible linXers. 

2 Your module may be accessible through the syntax “^d foe 

system to process the commands one at a time. 

Those .odules which ace not accessible In these two 

wlt^the differences In form. The structure of each call follows the 

««e pattern, when a particular 'V, “‘“Sk caU 

variation Is noted at he time of requirement. The variation call 

will be in the form listed below. 


(parameter, parameter, ... » parameter] 


Parameters may be optional, as indicated for each verb. All 
FORTRAN programs will require the FORTRAN CALL ° ^ 

ceed the PLOTWARE-x* verb. The parameters l" 

parentheses, as pec standard *ms the tollo- 

of the basic difference between these two '"J® 

wing program calls indicate the command, in both tor ms, 
required to establish a plot on a dot matrix of TYPE 1 . 

EXAMPLE: 

FORTRAN call: 

"^n snd -y are specified parameters., 

COMMAND FILE OC INTERACTIVE call: 

PLOTS TYPE 1 

YOU will notice a difference In the basic , 1 ®° 

reflect their fcee-focra, BASlC-liXe structure. 

This part of “‘rsWiur' t‘rth%°’g?amL°r- 

^h*» svfitem. The syntax can be said to be simiiai 

of a speaking language. Hence there are some conventions ot syntax 
which ace followed here. 

A Each command begins with a VERB or COMMAND. This command is 
Ssed to invoKe a computing module of^ the system. Hence 
referred to as a •module". 

B. Each module may be followed by modifiers which are required 
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to enable the computing module to perform the commanded task. 
These may be referred to as "parameters". 

C. The parameters are grouped into three categories. They may be 
VARIABLES, signified by upper case letters which are ex¬ 
plained in the text following the module declaration. These 
may take ort numeric values. In the compiler forms, of cour¬ 
se, these may remain variables, but in the COMMAND FILE form, 
they must be expressed as their actual value. 

D. Another form of the parameter is the "literal". This is a 
string of characters which are alphanumeric in nature and may 
be used for titles, headings, and similar things. They are 
always represented as strings of characters enclosed in 
quotes or apostrophes (sometimes referred to by programmers 
as a "single quote"). This allows the inclusion of either of 
these special characters within the literal. The only rule to 
follow when forming literals is to always terminate the 
literal in the same way that you began it. For example, if 
you started with quotes, finish with quotes. Here are two 
properly formed literals: 

"Anybody*s guess" 

*AMO HITB APOSTROPHES' 

E. The last form of parameter is the DISK PILE NAME. This is 
usually enclosed in quotes or apostrophes as well. The name 
is formed in the standard way in which your operating system 
requires disk files to be formed. This is explained in your 
computer system documents and will not be approached here. 

P. Some parameters may be enclosed in parentheses in the COM- 
HAND PILE form. This is usually the case when optional forms 
of the modules are available to extended functions. 

G. As is true of verbs, some modules may have more than one 
"conjugation". For example, the AXIS module has six forms. 

H. While entering the actual items for parameters and/or 
literals, use these rules: 

1. All literals will appear as entered. 

2. Parameters may have upper or lower case letters inter¬ 
changed. 

PLOTHARB-z* contains many facets of operation, in it's complex 
tructure. These facets are loosely grouped into "modules". Bach 
module" nas been directed to perform one specific project on a 
given graphics device. 

These modules are described below, in alphabetical order. 

I. ARC; 

This module serves the purpose of generating arcs 
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(portions o£ a circle) of specified dimensions. 

2. AXIS: 

This module serves the purpose of generating axis groups for 
graphs. It includes all variation calls: AXISA, AXISB, AXISC, 
AXISD, and AXISLG. It also includes information on the spe¬ 
cial entry point GRID. 

3. CHART: 

This module will generate the PIB and BAR charts. It in¬ 
cludes verbs which provide for special shading and coloring 
accents. 

4. CIRCLE: 

This module generates cirlces of specified dimensions. 

5. DATA; 

This module is used in the COMIIANO PILE and INTERACTIVE mode 
in order to enter data into the plot. 

6. PRINTHAP: 

This module-will automatically draw dot matrix printer graphs 
from the data base generated tor dot matrix (raster scan) 
printers. However, when stated as a stand alone verb at the 
operating system level it*s function will be to generate 
multiple copies of a graph on the printer. 

7. EXIT: 

This module allows for the termination of the interactive or 
disk attachment program. 

8. FACTOR: 

This module allows for the reduction or enlargement of 
all subsequent graphic commands. 

9. PONT; 

This module changes character sets. It may be implicitly 
called from SYMBOL 

10. POMTPQ: 

This module allows the selective modification of the ornate 
characters appearance. Width, height, slant, and skew can be 
added to any of the characters with this feature. 

11. GRID; 

This module generates linear, logarithmic and linear-log 
grids with solid borders. The user has a choice of solid, 
dashed, or mixed grid lines. The GRID command should be 
specified immediately before the AXIS command to insure a 
GRID graph. 

12. LINE: 

This module draws line points or lines whicn convert the data 
values to the proper perspective of the axis used in inches. 
LINELG and LINEX variations are included in this module. 

13. NBWPEM: 
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This module specifies pen changes for plotters and ribbon 
changes for word processing printers. This module specifies 
action for the ribbon carrier, if so equipped, on word proce¬ 
ssing printers. It will also specify special action by dot 
matrix printers to emmulate color. 

14. NUMBER; 

This module allows the drawing of numbers in any size and at 
any angle. It includes these variations of the term NUMBER: 

NMBERL» just if icat ion of number used to the left. 

NMBERR » justification of number used to the right. 

NMBBRC ■ justification of number used to the center. 

15. PLOT; 

This module draws "point data" in "pen" movements. PLOT is 
the basic routine of all of the other modules and is freque¬ 
ntly called upon by the PLOTWARE-z* program. It’s accessib¬ 
ility to the user gives him the ability to manipulate the x - 
y data and order the rudimentary "pen up" and "pen down" 
movements. Extensions here include enlarging or shrinking 
the plot and rotating it about any point inside or outside of 
your object. PLOT is useful for collecting a series of plots, 
specified by various programs, into one composite plot. It 
is also useful for logos and other frequently plotted items. 

16: PL0T30: 

This module Is for compiler 
the PLOT verb except that X,^ 
drawing. See also verbs ZPER 
for complete 30 information. 

17. PLOTS: 

This module primarily serves 
fies a "convenient" page siz 
using dot matrix or word pro 
cribes the PLOTSX variation. 

18: REORAH: 

This module allows the user 
binary disk picture of his 
BUFFER as installed at your 
display this picture at some 
reduced, rotated, projected 
combination of these actions. 

19. SCALE: 

This module has two primary functions. First, it examines 
raw data and calculates scaling factors. Second, it adjusts 
these factors in order to allow for a pleasing, even-numbered 
annotation value to be used in the x - y line graph. The 
following three extensions are included within this module. 

SCALBX = extended scaling 
SCALBL * logarithmic scaling 
SCALEM * manual scaling 


attachment and is analagous to 
{,1 data is used to create a 3D 
SX, 2PERST, 2SWAPX, and ZSWAPV 


to initiate a graph. It speci- 
e for graphic displays when 
cessing printers. It also des- 


the ability to create a packed 
picture (through the PICTURE 
specifications) and then re- 
other time. It can be enlarged, 
into three dimensions, or any 
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20. SYMBOL: 

This module draws printed symbols, or special "£)oint" data 
to accentuate "points" of the graph. Symbols may be produced 
to any size specifications and any angle of inclination. 
SYMBOL allows the text strings to be justified to the left, 
to the center or to the right. 

21. WHERE: 

This module allows the user to return the pen to the last 
exact drawing location, (compiler usage only) 

22. XYSIZB: 

This module allows the user to change the size of the drawing 
page. XYSIZE is only applicable to dot matrix printers. 

23 ZPERSX* 

This module allows the user to establish a perpective in 
three dimensions. It provides for a true three dimensional 
viewing perspective allowing for the selective viewing of the 
object from any viewpoint, at any rotation. It provides a 
mechanism to allow magnification and projection, simulating a 
microscope with magnification far greater than I0,000X to a 
wide angle view greater than any current "fish-eye" lens 
currently available. The ablity to produce animation and the 
"sense of movement" (in flight, etc.) is available through 
this module. 

24. ZPERSY: 

This module cancels the effects of ZPERSX. 

25. ZSPEEDs 

This module specifies the speed of the CPU in systems requi¬ 
ring wait cycles. This feature is found only in printers 
which operate under the "older" GRAFTRAX (EPSON trademark) 
eproms. 

26* ZStiAPXs 

This module allows the "swapping" if the X specification witn 
the Z specification in the three dimensional features. This 
is a short cut to producing a 90 degree rotation of the 
selected plane. 

27 * ZSHAPY« 

This module allows the "swapping" if the Y specification with 
the Z specification in the three dimensional features. This 
is a short cut to producing a 90 degree rotation of the 
selected plane. 

This concludes the introduction to the PLOTWARB—s* modules. It is 
now time to look in depth at the working purpose of each moaule. 


ARC: 

The ARC module allows the user to draw an arc on the 


plotting 
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surface. 

SYNTAX: 


(COMMAND FILE FORM) 

ARC XPAGB,YPAGB,01AMETER,ANGLESTART,ANGLCSTOP 
where: 

XPAGB, yPAGB describe the center of the arc. 

DIAMETER is the diameter of the arc in inches. 

AMGLBSTART and ANGLBSTOP define the beginning and ending loca¬ 
tions of the arc, with respect to the center. These are in 
degrees. 

EXTENDED SYNTAX: 

(COMMAND PILE FORM) 

ARC XPAGB,YPAGB,STBPSlZB,DIAMETER,ANGLESTART,ANGLESTOP 
Where: 

STBPSIZB is a NEGATIVE number whose absolute value describes 
the distance between points used to draw the arc. It is usually 
.01 in the standard form, but can be modified in the extended 
form in order to more efficiently take advantage of the media on 
which the arc is drawn. On CRT screens which have a 500 or 600 
by 200 or 300 pixel matrix, the value should be around .06. On 
Plotters which have very fine resolution and require a perfect 
arc to be drawn (as on the ZETA 8 plotter) the number may be 
reduced to .003 or so in order to obtain a perfect arc on the 
paper. 

AXIS: 

The purpose of AXIS is to generate an x - y axis, which can be used 
with X -Y graphs and bar graphs. Grids may be generated when AXIS is 
used, first, for the vertical lines, then for the horizontal lines, 
in conjuction with the verb GRID. The grids may be solid lines, 
dashed lines or a combination thereof. AXIS will also serve to 
generate any special purpose display, which requires the drawing of 
a ruled line, or "tic mark" indexed segments with possiole annota¬ 
tions on the segments, or the axis itself. * 


SYNTAX: 

standard FORTRAN: 
basic X - y axis: 
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CALL AXIS (XPAGB,YPAGE,IBCD, NCHAR,AXLEN,ANGLE, 

FIRSTV.DELTAV) 

This for* generates an axis, with annotations expressed in the 
specilied values, with two deciisai points. The tic marKs used in 
the annotation are I inch apart. This is the same syntax construct 
used in the "large mainframe" software. 

EXTENSIONS: 

The following extensions allow the user to vary the x -y graph. 

INTEGER ANNOTATION: (TYPE "A") 

CALL AXISA (XPAGB,YPAGE,IBCO,NCUAR,AXL£M,AMGLB, 

FIRSTV,DELTAV,TIC FAC,NUHDEC) 

This form gives the same axis type as above, but the distance bet¬ 
ween tic marKs and the number of decimals to be used on the tic mark 
annotations are specified. 

EQUI-LENGTH ALPHANUMERIC NOTATION: (TYPE "B") 

This allows for an x - y axis with alphanumeric annotation on the 
tic marks. All of these annotations ace a specified number of 
characters in length. 

CALL AXISB (XPAGB,yPAGB,IBCD,MCeAR,AXLBH,AMGLE, 

FIRSTV,DELTAV,TICPAC,TICARA) 

COMMAND PILE and INTERACTIVE: 

AXISB XPAGB YPAGB IBCD NCHAR AXLBN ANGLB 

FIRSTV OBLTAV TICPAC annotation-length "annotation" 

In this case, PIRSTV and DELTAV ace included for adjustment and use 
with the SCALE and LINE routines. The actual annotations used at the 
tic macks ace not plotted to reflect these values. They ace com¬ 
puted with these values, but ace taken from the literal array TICA- 
RA. This allows the annotations to express months, coded limits and 
items which ace not usually expressed in a numeric form. 

ANY-LENGTH ALPHANUMERIC NOTATION, PUBLICATION FORM: (TYPE "C") 

This provides an x - y axis with extended alphanumeric labels which 
are not of the same length and are too long to fit on the annotation 
tic macks, without running together. 

CALL AXISC (XPAGE,YPAGE,IBCD,NCHAR,AXLEN,ANGLB, 

FIRSTV,DELTAV,TICPAC,TICARA) 

COMMAND FILE and INTERACTIVE: 

AXISC XPAGB,YPAGB,IBCO,NCHAR,ASLEM,ANGLE, ‘ 

PIRSTV,DELTAV,TICPAC," ... annotation ...." 
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This places the annotation perpendicular to the axis. It adjusts 
the label of the axis to leave sufficient room for the longest 
annotation to be placed on the tic mark. This is the normally 
requested format of abstract and formal presentation papers. 
This program will give camera ready copies without the usual 
extra drafting required for professional presentations. 

PUBLICATION FORM, FOR X AXIS USE; (T^PE "D") 

This provides an x - y axis with the annotations of AXISC. 

(AXISC will not draw on a 45 degree angle.) 

CALL AXISO ( ... (SAME PARAMETERS) ... ) 

The annotations are placed at a 45 degree angle to the axis. This 
leaves room for long annotations, yet maintains the readability of 
the chart. 

UXS AXIS ANNOTATIOM: (TYPE *LG*) 

If this form is used to express the graph in terms of the magnitude 
(LOG 10) of the data, rather than in the actual data itself, a 
special module for the drawing of axis is encountered, since the tic 
marks, annotations, and lines are all expressed in terms of the 
magnitude of the data. 

CALL AXISLG (XPAGB,YPAGE,IBCO,NCaAR,AXLBN,ANGLE,PACTLl, 

PACTL2) 

PACTLl and PACTL2 are calculated with SCALE using the log version. 
Always call SCALE (log version) before calling AXISLG. Then use the 
calculated values for PACTLl and PACTL2. These correspond to PIRSTV 
and OELTAV of the linear axes. 

(more on PACTLl and PACTL2 ip "MANUAL SCALING") 

INTERACTIVE or COMMAND PILE SYNTAX: 

AXIS » same parameters as above, without parentheses 
AXISx « same parameters as above, without parentheses. 

(x is A,B,C,D, or LG) 

XPAGE,YPAGE: 

These are coordinates of the starting point of the axis, in inches, 
with respect to the present "origin". These must be zero when using 
LINE and SCALE routines to adjust data to the axis. Use PLOT to 
change the "logical" origin if necessary. Listed here are two 
instances when this change would be necessary. 

1. It would be necessary when placing several plots on one page. 

2. It would be necessary when the origin is the lower left-most 
position on the plotter and the ticmajks, annotation and 
label would be positioned outside of th*e plotting "window". 
(This is always true on dot matrix printers.) 
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Th^s is the annotation data to be used as the title of the axis* 
This can be a literal or an array of any type desired, provided the 
data characters are contiguous. 

This'* indicates the number of characters in 

If it is negative, the title is placed^ below ^s 

tcwisel This is the usual case with the x axis. If the 
positive, thi title is above the a.is. In the INTERACTIVE / COHNAND 
PILE lot-, this -ay be 99 ot -99: The of ‘JV* “ 

detet-lned by counting the chatactecs in the 

for this parameter. The labourlous counting of characters for the 
title can be eliminated by this form of call. 

AXLBN: 

This is the length of the axis, in inches. 

Thiels the angle at which the axis is to be drawn. This is usually 
expressed as 0.0 for the X axis and 90 for the Y axis. 

PIRSTV* 

This i*s the beginning value, to use to annotate the 4® 
the axis. It is ignored, when 

which use alphanumeric annotations. In the INTERACTIVE / CON HAND 
PILE form, this may be 999 and the previously calculated scaling 
factors from SCALE will be used for PIRSTV and DBLTAV or PACTLl and 
PACTL2. 

This is the increment value to apply to the tic *arxs, in their 
annotation (from the PIRSTV value). It is also to be ignored if one 
is usin9 alphanu«6cical annotations* 

TICFACs 

This is the distance, in inches, between the tic marks of the axis. 
NUHOBC* 

This specifies the number of decimals to be used as ^''^otations past 
the decimal point. If the given value is zero, no decimal point 
will be drawn. 

TICARA* 

This i, a logical attay ulth tha tic -aik 
When all of the elements of the annotations ate 
ele-ent one is the length of the annotation of 
ments 2 through N are tne tic mark annotations 

must be a single byte/character array. If this is oa^a- 

INTERACTIVB / COMMAND PILE form, this entry IS made 4° P®,!® 

meters. The first indicates the length of eacn parameter. The 
second is the annotation itself. ^ 


The following would produce an axis labeled with abbreviations 
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for the ficst six months of the calendac year. 

3 *janfeb«acapcaayjun* 

This saae example, stored in the array, tor Fortran use, and used as 
a literal in the calling parameters would appear as follows. 

*3janfebmacapcmayjun" 

This is a logical array for variable length and longer annotations, 
since the annotations ate presented in groups. Each group will 
consist of a logical value, which gives the length of the annota¬ 
tion, followed by the annotation itself. These groups ate pteceeded 
by a single value, which is the maximum annotation length. 

Example: 

If your annotations are "ABC", "DEPGH", and "XY" 
then TICARA would be: 

"53ABCSDBFGH2XY* (in FORTRAN) 

INTERACTIVE / COMMAND PILE format calls for the specification to be 
made by using a series of parameters. The first is the total number 
of literal strings used as the annotation. In the above case, this 
would be: 


... 3 "ABC* "DEFGH" "XY" 

When building an array, in a compiler program, which will link the 
routines as inline subroutines, the length parameters can be expre¬ 
ssed as either the actual values of the lengths or as the literals 
representing these lengths (as seen above). When annotations are 
greater than nine characters in length, the use of literals will 
assist to express this length. Use the ASCII chart to find literals 
for greater value than nine in order to express this length. 

Example: Use a for a length of 10 and a ";" for a length 
of 11. 

MANUAL SCALING: 

Manual scaling may be used if you wish to specify your own parame¬ 
ters. 

FOR LINEAR AXES: 

The FIRSTV references the first number to occur at the origin of the 
graph. It is the beginning value to be used on the graph. DBLTAV is 
a number, which will be added to FIRSTV, to obtain the printed value 
at the next mark. 


FOR LOGARITHMIC AXES: 

FACTLl and FACTL2 correspond to FIRSTV and DBLTAV, however their 
meanings are related to BASE 10 functions. 
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FACTLl; “powfr OF 10 VALUE" at the axis origin. It can 

shows this to be the inverse o£ the length o£ one log cycle. 
sfaUng is a complex art and extensive^ 

Should be acquired before a . deltaX to 11 and PIRSTX 

To^l^ ?h%^tould°r°eruft i^a very unu'sual graph. 

“Jbe -Uiples 2 5 oc -Aea“an‘ 

tic mark. 

CHART 

CHART is a verb wnich invokes the "business chart" and functions 
with bar and circle charts. 

SYNTAX; (COMMAND FILE oc INTERACTIVE only) 

CHART Ikind) (modifiers! 

where (kind] is; 

PIE or CIRCLE 

followed by (modifiers! ; 

XPAGE.YPAGE, DIAMETER, 

DATA (color) -segment label AMOOHT, 

DATA...! repeated as needed for each segment), 

END 

or where [kind! is; 


followed by (modifiers!: 

XPAGE,YPAGE,XLENGTH,YLENGTH,VERTICAL or HORIXONTAL code, 

DATA...(repeated as needed lot each amount ot bat) END 

Here is an explanation of the "modifiers . 

XPAGE,YPAGE: 

This is the "origin" of the chart. 
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In the creation of a CIRCLE or PIE chart, XPAGE YPAGB is the center 
of the circle. In the creation of the BAR chart XPAGE YPAGB is the 
lower left corner of the axis group. 

DIAMETER: 

This is the diameter of the circle for the CIRCLE or PIE chart. 
It is expressed in inches. 

XLENGTH. YLENGTU: 

This specifies the length of each axes used to build the BAR 
chart. XLBNGTH is for the horizontal axis and YLBNGTH is for 
the vertical axis. These are expressed in inches. 

VERTICAL OR HORIZONTAL: 

This is a required entry in the BAR charts. It specifies 
that the bars drawn will be drawn either vertically or horizon¬ 
tally. One and only one of these options must be in each CHART 
specification. Use the number 1 to indicate preference of a 
HORIZONTAL graph and 0 to indicate preference of a VERTICAL 
graph. 

BARMI0T8: 

This specification can be optional, but some value must be 
present. If the width is set at 0, the software will calculate 
and present the most appropriate width and distance between the 
bars. If the user opts to order a different width setting, the 
opportunity is provided to enter data into BARMIDTU and BAR- 
SPACE. 

BARSPACB: 

This specification is required. It signifies the distance 
between the bats of the chart. A carefully calculated oivision 
of the bars will insure an attractive graph. 

•X label": 

This is the label to be used on the horizontal axis. 

•Y label": 

This is the label to be used on the vertical axis. 

DATA: 

This item begins an entry which will specify the quantity of 
a portion of a chart. The verb DATA must be entered before 
each quantity of each portion of a chart is assigned. Anotner 
DATA statement or an END statement will conclude each quantity 
entry. DO NOT CONFUSE THIS STATEMENT WITH THE X - Y DATA STATE¬ 
MENT. see page 

(color): 

This is an integer item which may specifiy a color to a specific 
segment or bar of the chart. COLOR is optional and may be har¬ 
dware dependent. 

"segment or bar label”: 

This is the actual label appended to the segment or bar of the 
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chart. The label will be included inside the segment of a 
circle chart. If the label requires mote room than is allowed 
inside the segment, it will be produced outside of, but pointing 
directly to the segment. If a BAR chart is drawn, the label will 
be used as the individual annotation on the axis which serves as 
the base axis for the bats. Caution should be used when speci¬ 
fying these, for lengthy segments will result in a clumsy appea¬ 
rance of the chart. They will be drawn by the software, but the 
large space allocated to a long label might mar the professional 
appearance of the chart. 

AMOUNT: 

This is the quantity to be assigned with each segment or bar of 
the chart. When producing a CIRCLE or PIE chart, the software 
will check all amounts encountered until the END statement, 
for "reasonable values". This means that the amounts encountered 
must be equal to or less than 100%. If the amount exceeds 100%, 
an error message will result. If the amounts entered are equal 
to less than 100% this will facilitate the automatic inclusion 
of another segment labeled "OTHER", as needed to fill out the 
pie to 100%. Its color will be in the default color (usually 
black or "pen number 1") of the hardware device drawing the 
chart. Its amount will be the difference between the total of 
the specified amounts and 100%. 

AMOoirri: 

This specifies the amount of the "major" bar of the drawn bar. 
ANOONT2: 

This specifies the amount of the "sub bar" of the drawn bar. 

AHOOMTl and AMOUNT2 are used to allow the inclusion of two- 
piece bars, on the bar chart, as shown in the examples given 
for the BAR CHART functions. 

SHADS: 

The numbers 1 or 2 or 3 will specify the amount of shading to be 
given to a bar. The number 1 orders that no shading is to be 
performed. The number 2 provides for single, angled lines. The 
number 3 provides a cross hatched pattern, for the densest 
shading available. The angle at which the lines are drawn is 
calculated based on the angle between opposite corners. This 
gives a consistency to the appearance of each bar on the chart. 

DENSITY: 

This specifies the distance between shading lines. DENSITY is 
determined by specifying how many lines are to be drawn per 
inch. This is a required entry. Even if tne SHADE option is 0, 
this entry is required for proper syntax. 

END: 

This item must be the last item of any chart specification. The 
chart process begins the drawing of the chart, following the 
occurrence of the END verb. The user may then use other CHART 
options, or any of the other available options such as SYMBOL, 
to label the overall page on which the chart is located. If no 
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other items ace required, the normal item to be entered follo¬ 
wing the END would be an EXIT statement. 

OPERATIONAL NOTE on CHART: 

As the CHART program runs, it examines the amount of memory availa¬ 
ble. It then calculates the amount of "line" storage available. 
This calculation is displayed, along with the copyright notice, 
before any plotting action begins. 

CIRCLE: 

The CIRCLE module allows the user to draw a circle on the plotting 
surface. 

SYNTAX: 

(COMMAND FILE FORM) 

CIRCLE XPAGE,YPAGE,DIAMETER 
where; 

XPAGE, YPAGE describe the center of the arc. 

DIAMETER is the diameter of the circle in inches. 

EXTENDED SYNTAX: 


(COMMAND FILE FORM) 

CIRCLE XPAGE,YPAGE,STEPSIXE,DIAMETER 
Where: 

STEPSIXE is a NEGATIVE number whose absolute value describes 
the distance between points used to draw the circle. It is 
usually .01 in the standard form, but can be modified in the 
extended form in order to more efficiently take advantage of the 
media on which the circle is drawn. On CRT screens which have a 
500 or 600 by 200 or 300 pixel matrix, the value should be 
around .06. On Plotters which have very fine resolution and 
require a perfect circle to be drawn (as on the ZETA 8 plotter), 
the number may be reduced to .003 or so in order to obtain a 
perfect circle on the paper. 

DATA; 

The purpose of DATA is to specify a data set to be used in X - Y 
line graphs. Raw data (not converted to inch equivalents) must be 
used. If converted data is used, it must be accompanied by the 
appropriate scaling factors included as the last two data points of 
the data set. (see MANUAL SCALING in the AXIS section) Each data 
set must have the data ordered into X - Y pairs. These X -Y pairs 
must be in a free form ASCII format, with integer or real (decimal) 
numbers. Any number of DATA verbs may be Dsed in the generation of 
an X - Y graph, but the total number of data point pairs must not 
exceed the maximum number allocated from the memory space. This 
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nuabec is always displayed when the CHART progcam is initiated. 
SYNTAX - COMMAND FILE: 

DATA n "datafile" 
where: 

"datafile" is in the standard disk file naming convention: 
NNNNNNNN.EXT 

Following the occurrence of "data file", a search will begin for 
X - Y pairs and will continue until an end of file entry is 
encountered. The structure of the file is free-form. All X-Y 
pairs are represented as integers, reals or a combination of the 
two. Any number of X - Y pairs may be in a single record. There 
is no realistic limit to the number of X -Y values which can be 
contained in one logical record. The only formatting require¬ 
ments are that an X - Y pair cannot span a logical record, and a 
single X or Y value may not span a record. "n" is a number 

which orders that number of records to be read from the file 
prior to processing the data. It can be omitted if no records 
are to be skipped. When several data sets are placed on a single 
graph, each data set must be specified by a separate DATA verb 
statement. The first statement will be numbered as 1. As the 
SCALE and LINE statements are used to enter insuing data sets, 
an implicit numbering system will yield the necessary line 
number, required for all later statements. Therefore, if the 
software has encountered 6 DATA statements, it will number them 
as LINE 1, LINE 2, LINE 3, LINE 4, LINE 5 and LINE 6. When, at 
any point after entry is completed, the user communicates with 
the software, about a data statement, LINE and the appropriate 
number must be referenced. 

When buiding an X - Y graph, the following order must be obser¬ 
ved. 

DATA statement 


DATA statement (the last one) 

SCALE statement (for the X's, if needed) 

SCALE statement (for the Y's, if needed) 
optional GRID statement 
AXIS statement 
optional GRID statement 
AXIS statement 

LIME statements (one for each DATA statement) 

PRINTMAP: 

The purpose of PRINTMAP is to draw the graphic display on dot matrix 
printers. It is the essential process of vector to raster conversion 
that is required for the dot matrix printers to generate the entire, 
complete picture in a single pass. There is no practical limit to 
the number of pictures which can be stor'ed in a single conversion 
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tile in a data base tocmat« because each picture becomes one single 
unit of the complete plot. Most "usual" graphs and charts of reaso¬ 
nable complexity require between 25 and 40 sectors (of 128 bytes 
each) to store the data base segment for that graph or chart. PRIH- 
TMAP may also be used as a seperate progam to REDRAW the last 
picture (s). 


SyNTAX; 


PRINTMAP 

This call is at the operating system level. The picture name is 
always PLOTWARE.DAT. 

EXIT: 

The purpose of EXIT is to provide a way to close the data base in 
the INTERACTIVE / COMMAND FILE form of tne PLOTWARE-z* system and 
to begin the processing of the data. It is not required in self 
terminating plotter and word-processing printer systems. This option 
begins an automatic call to PRINTMAP. The graphic data generated 
will then be drawn on the printer. 

SYNTAX: (for FORTRAN) 

CALL PLOT (0.,0.,999) 

This form was chosen in order to retain consistency with the syntax 
of large mainframe computers. 

DO NOT USB THE FORM: CALL EXIT 

SYNTAX: (Command File) 

EXIT 

FACTOR 

The purpose of this routine is to provide the ability to modify 
the actual size of the displayed picture. If the FACTOR is set 
to .5, for instance, all subsequent display commands will pro¬ 
duce a half-size product. This can be useful in the debugging 
stages of a graph or chart. It snortens the plotting time and 
gives a "rough" miniature copy of the final product. 


SYNTAX 1 

standard FORTRAN: 

CALL FACTOR (FACT) 

FACT is the desired factor. 

INTERACTIVE / COMMAND FILE call: 
FACTOR factor 
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FONT: 

The FONT module directs the system to use a new set of characters in 
the generation of any further alphanumeric representations on the 
graphs. This is to allow the user access to the "UBRSilEY FONTS" 
(named after the man responsible for digitizing them) in pictures. 
This is an optional feature and must have the proper options instal¬ 
led in PLOTWARE-z* in order to make the characters available. 

SYNTAX (compiler form) 

CALL NEWFNTCliteral) 

SYNTAX (COHMAMD FILE form) 

FONT literal 

Mhere: 

The literal describes the name of the font to be used. The 
tables of the fonts are in the example section. This literal 
must match the name at the heading of the table of characters 
which you desire to access. The name is limited to six charac- 
terSf so you need enter only the first six characters of any 
name. 

GRID: 

The purpose of GRID is to allow a grid to be generated on an AXIS 
set. It is often useful to apply an overlay, of some sort of grid, 
particulary when using log plots, to more accurately display the 
line data. This option allows a "solid line" grid, composed of 
evenly spaced lines, log spaced lines, or a solid line at regular 
intervals with dashed lines between the solid lines. GRID is actual¬ 
ly a special entry point into the AXIS command and is invoked by 
specifying the GRID verb immediately before specifying the AXIS 
verb. It is not necessary to avoid intervening commands, but the 
GRID verb effectively "turns on" the gridding software, and the AXIS 
verb, as it finishes, "turns it off". 

SYNTAX (COMMAND FILE or INTERACTIVE) 

GRID GRIDHBIGBT DASBLBNGTH DASBINTBRVAL 

where: 

GRIDBBIGBT; 

This is the height of the lines to be drawn perpendicular to the 
axis. The GRIDHEIGUT of the X axis would normally be the length 
of the Y axis. 

DASBLENGTH: 

This is the length of the dashes, when dashed lines are used. 
Solid lines will always occur at the ends of the axis, but may 
be specified at regular intervals if the DASBINTERVAL option is 
given a quantity , in inches, other than zero. 

DASBINTBRVAL: 

This is the interval at which solid lines are to be encountered. 
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If DASHINTBRVAL is 5, every fifth line will be solid. If OASiil- 
NTBRVAL is zero, all lines will be solid, 

LINE: 

The purpose of line is to place a data set, as specified by X - 
Y data points, onto a line or X - Y graph. 

SYNTAX 

Fortran ("standard call") 

CALL LINE(XARRAY,YARRAY,NPTS,INC,LlNTyP,INTEQ) 

Fortran ("extended call") 

CALL lihex(xarray,yarjray,mpts,iik:,limtyp,inteq,ticpac, 
TICFACY) 

COMMAND FILE or INTERACTIVE : 

LINE linenu«ber,NPTS,INC,LIHTYP,INTEQ 

LINE! linenu«bec,NPTS,INC,LINTYP,INTEQ,TICFACX,TICPACY 
LOG type (only) 

CALL LIHBLG(XARRAY,YARRAY,MPTS,LINTYP,INTEQ,LOGTYP,TICPACL) 
LINELG linenuBbec,NPTS,LINTYP,lNTEQ,LOGTYP,TICFACL 
where: 

XARRAY, YARRAY: 

These ace the REAL arrays used in the FORTRAN progran to store 
the X and Y data. 

NPTS: 

This is the nunber of points in the arrays of X and Y data. 
Also see AXIS for an explanation of the manual scaling process. 
If NPTS is zero, then (in COHHANO FILE or INTERACTIVE mode only) 
the actual number of data points, will be used in this value. 
This saves laborious counting of the data points. 


INC: 

This is an optional increment for selecting data points. It is 
usually set at 1. If it is set at 2, then every other data 
point will be selected. If it is set at 3, then every third 
point will be selected, etc. 

LIMTYP: 

This is a parameter, which specifies an optional marker, to be 
drawn on each specified point. This marker can be one of four¬ 
teen different centering markers. These, are shown in the chart 
of symbols in the example section, page ^*^0 It LINTYP is zero, 
the line drawn will have no markers drawn at any point. If 
LINTYP is greater than zero, tne data is represented by a line. 
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with Barkers drawn at specified points on that line. For insta¬ 
nce, if LIHTYP is valued at 3, a marker will be presented at 
every third point. If LINTYP is less than zero, no line ap¬ 
pears. Only marker symbols will be drawn. These will be at 
intervals specified by the absolute value of LINTYP. If LINTYP 
is -3, there will be no line. Only markers will be drawn at 
every third point, etc. It is easily seen that LINTYP is 
usually -1, 0 or 1. 

INTBQ: 

This specifies which marker symbol to use. See the chart of 
symbols page to verify the the appearance of the markers that 
INTBQ will yield. These choices are seen in the first fourteen 
entries shown in the first column. 

LOGTYP: 

0 means *LOG-LOG* 

1 means *LOG-linear in X" 

-1 means "LOG-linear in Y" 

TICFACX,TICPACY are the "ticfactors* for the plot. 

See AXIS and SCALE for details. 

TICPACL is the tie factor for the linear axis, if one is 
used. 

NEMPBN: 

The purpose of NEHPBM is to provide the user with the opportunity to 
change to a different colored pen, if the hardware of the user will 
allow for this option. This ability is usually found only on spe¬ 
cially equipped, multipen plotters, dual color ribbons on word 
processing printers, or on color CRT'S. 

SYNTAX 

CALL NBWPBN(colocnumbec) 

NBUPSM colornumber (COHHAND PILB or INT8RACTIVB) 
where: 

colornumber is a number in range of the hardware device. For 
example:! - 4 on the CPS plotter. This device is for a 
special use on dot matrix printers. 

EXAMPLES: 

CALL NEHPBM (3) (Poctcan) 

NEHPBN 2 (COMMAND PILB / INTERACTIVE) 


FOR DOT MATRIX PRINTERS: 

It is possible to generate very impressiv» pictures on dot matrix 
printers, by using a “three color process", which is offered by 3-M 
and other manufacturers. This requires three sheets for the picture 
(split into the three primary colors). 
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The process is as follows: 

RUM TOUR *JOB" three tiaes. 

The first time, immediately after the PLOTS 
statement use NBMPBM -1 (or call NEMPBN 
(-1) for Fortran. 

The second time use -2 in the NBMPEN 
statement. 

The third time use -3 in the NEWPBtt 
statement. 

This gives the three sheets needed for the color process. The 
actual process will not be explained here. See your 3-*H dealer 
for additional information. 

TABLE; 

"Color Mixing" for single color dot matrix printer: 

Use NEWPEH for colors 1-7 to get the folowing combinations. 

NBMPBM COLOR MIX (mixes these colors) 

1 1 and 2 and 3 

2 1 

3 2 

4 3 

5 1 and 2 

6 I and 3 

7 2 and 3 

Obviously "color 1" will usually give a "black" color. The white, or 
"light" color possible with this 3 color process is used as the 
background or "filler" color. This would correspond to "color 3", 

NOTE; 

There are no examples of the above commands as with the other verbs. 
This is obviously due to this documentation being available in only 
one color of ink. It is left to the reader to visualize the effects 
of multi-color plots. 

NUMBBR 

The purpose of this routine is to "draw" teal (floating point) 
numbers on the plotting device, with any necessary scientific nota¬ 
tion as needed to represent a floating point number. The software 
is capable of drawing this in any size, rotating the numbers at any 
angle, and centering the product about a given point, as well as 
right or left justifying the number at any point specified. These 
options are identical to the options available with the SYMBOL 
routine. 

SYNTAX 

Fortran: (standard, "compatible" call) 

CALL NUMBER(XPAGE,YPAGB,HBIGUT,PPN,ANGLE,NOBC) 
extended calls (left justify, center, right justify) 

CALL NUHBRL(XPAGB,YPAGE,HEIGHT,PPN,AN^LB,NDEC) 
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CALL NUHBRC(XPAGB,ypAGB,HEIGHT,FPN,ANGLE,NDEC) 
CALL NUHBRR(XPAGB,YPAGB,HEIGHT,PPN,ANGLE,NDEC) 


COHHANO PILE or INTERACTIVE : same, without parentheses 
where: 

XPAGB,YPAGB: 

These specify a point where the number is to be referenced. 
This is the lower left of the leftmost character position, if 
the number is to be left justified, the lower right of the 
rightmost character, if it is to be right justified, or the mid¬ 
point between these two positions, if the number is to be cen¬ 
tered. These measurements are in inches, relative to the (cur¬ 
rent) origin of the plot. 

HEIGHT: 

This is the height, in inches, of each character used to make 
up the number as it is drawn. 

PPM: 

This is the floating point number that is to be drawn on the 
plotting area. 

ANGLE: 

This is the angle at which the number is to be rotated, as 
referenced to the plotting surface. The rotation occurs about 
the point referenced by XPAGE, YPAGB. 

NDEC: 

This determines the number of "decimal precision" digits which 
are to be displayed, provided that NDEC is greater than or 
equal to zero. As the number is drawn, the whole number part of 
the number is drawn, then the decimal, then NDEC digits are 
drawn to the right of the decimal. 

If NDEC is -1, only an integer (no decimal point) is drawn. 

For compatibility reasons, the following two features are in¬ 
cluded: 

If NDEC is less than -1, the ABSOLUTE VALUE of NDEC -1 determines 
the number of digits truncated from the number while plotting. For 
instance, if 1234.56 were plotted with NDEC ■ -2, this would result: 

123 

The "continuation feature" on XPAGE and/or YPAGE; 

When X is equal to 999.0, then X is continued from the x posi¬ 
tion where the last SYMBOL call left off. If Y is equal to 999.0 
then Y is continued from the Y position where the last SYMBOL 
call left off. If both are equal to 999.0 the drawing of text 
continues immediately from the final position of the previous 
call to SYMBOL. 
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PLOT: 

The purpose of PLOT is to allow X - Y point data to be entered onto 
the plotting surface. This is the mechanisa used by all of the 
other routines to "draw" on the plotting surface. The procedure 
consists of simulating the human hand as it draws. The pen is 
lifted up, placed at a convenient “beginning point" and left down as 
it draws straight lines from that point to the next point of the 
line or curve to be drawn. Logically speaking, all lines are a 
collection of straight lines connecting many points, hence curved 
lines or complex figures are a collection of many, probably very 
short, lines- The PLOT routine expects the data to be presented as 
X - Y point data. The third specification of each point is that of 
the position of the pen, as that point is approached. This is the 
universal approach to all plotting of PLOTWAfifi-z*, regardless of the 
type of hardware which is used on the computer. 

SYNTAX 


Fortran; 

CALL PLOT (XPAGB,YPAG8,IPEM) 
COMMAND FILE or INTERACTIVE: 
PLOT data 


or (extended form 1) 

PLOT (PPACTOR XPl YPI ANGLE) data 
or (extended form 2) 

PLOT (PPACTOR XPl YPI ANGLE XP2 YP2) data 

Extended fora tl is used to place the plot data, specified in the 
“data" portion of the PLOT verb, with respect to XPl and YPl. This 
is the specification of a new “temporary origin" which is in effect 
only during the period of entering the “data" onto the plotting 
surface. In addition, the “data", whether it is actual data coded 
into the COMMAND PILE or INTERACTIVE Statement, can be rotated about 
the origin of the data itself. It should be noted that the data may 
be in a file, or may have been entered by digitizing some figure 
from a graphic digitiser. This file will have an “origin” of its 
own- This would be the original “origin" which was referenced during 
the digitizing process. It is this original “origin" about which 
the data is rotated. 

Extended form 12 is identical to extended form II except that the 
user can re~specify the “original origin" of the “data", brought in 
by the PLOT statement, before the rotation takes place. For insta¬ 
nce, assume that a LOGO has been digitized, and the logo is 5 inches 
by 5 inches. The “original origin" which j^as referenced by the 
digitizer, was the lower left cornet of the logo. The user now 
wishes to draw a 1 inch square logo on the front of a part which he 
has designed and drafted with PLOTWARE-z*. He also needs to turn the 
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logo 90 degrees in order to give it the proper placement on the 
part. It would be most convenient to specify that the CENTER of the 
logo was the position about which to rotate the logo. This would 
avoid some clumsy shuffling with a calculator or pencil. Thereforef 
he would let XPl and YPl refer to the very center of the logo 
oosition on the part he had designed. PPACTOR would be 0.2. ANGLE 
;ould be 90.0, and XP2 and XP2 would now be 2.5 each, in value. 
This would effectively shift the origin of the original data, as 
held in a separate "LOGO" file, so that the origin would appear to 
be at the center of the logo. The logo would be rotated about this 
center, which would be the exact point on which it was to appear on 
the part. 

PARAMETER EXPLANATION: 

XPAGB,YPAGE is the point referenced. 

IPBN must be 2 to specify "pen down". 

IPEN must be 3 to specify "pen up". 

IPEN can be -2 or -3, and the effect will be to move to the 
point specified, then make that point the NEW origin of the 
plot. (It will then appear to be 0.0,0.0). For "pen up" use -3. 
For "pen down" use -2. 

IPEN may be 0. If this occurs, this indicates that this is the 
last action to be taken on this particular plot segment. It can 
be used to make indefinitely long plots with dot matrix prin¬ 
ters, by specifying the plot as several segments, or it can be 
used to allow the user to service a pen plotter or word proces¬ 
sing printer before drawing another plot. This may be useful in 
producing a smooth flow with an otherwise complex drawing prob¬ 
lem. 

PFACTOR: 

This is a factor which can be used to reduce or enlarge the size 
of the data in the plot statement. It is referencing that data 
only, and no subsequent verbs will be affected by it. 

XPl and YPl: . . . , . w 

This is to reference a "temporary reference origin (or where 
exactly do I put this data on the plot?") for the placement of 
the "data". 


This is the angle of rotation (about the "original" origin of the 
"data" referenced by the verb PLOT) which is to be performed on all 
of the "data". The "original" origin is usually the same as the 
■plot origin". Examples would include logos, electronic symbols, 
Egyptian hieroglyphics, or mathematical symbols. 

XP2 and YP2: . . 

These refer to an adjustment to be performed to the "original 
origin" prior to rotation of the "data". 

"data": 

These may be one or more X - Y pairs with the IPBN specification 
attached and followed by tne word "END". It may be a file name 
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specified as a literal which will take the X ~ V paics« with an 
IPBH accompanying each, from that file name. This data is in 
fcee-format, and may be integer or real, except that the X and 
the Y and its accompanying IPBH value must all be encountered in 
the same logical record. 

OTE: When using the "embedded" form of plot data, there MUST be an 
END statement following the last X - Y and IPBH value. The software 
also expects to find an END statement at the end of all external 
plot data files. 

Example: 

PU)T 113222123212 END 

will draw an "X" of dimension 1 inch by 1 inch. 

If the picture can be drawn in segments or "frames", each data 
base segment may be terminated, with the special inter-plot call 
to PLOT, which uses a zero value for IPBH. If the dot-matrix 
option is specified, the word STAT will be displayed, followed 
by the listing of the statistics of that segment of the data 
base. There will be 21 items displayed. The first item is the 
actual number of 128 byte sectors required by that data base 
segment. The following 20 numbers are the NODE usage indices 
(the number of "tree branches" encountered in the data base 
structure itself). Each NODE usage index is a critical number# 
for it must be equal to or less than the maximum NODE capacity 
of the vector to raster scan program (PRINTKAP) or that program 
will terminate. This is not an actual NODE count, but rather a 
percentage based on the capacity of the ENERCOMP TWIN-2 computer 
which has about 80 K individual partition memory, with 63 K 
available to the user per partition. The capacity of this mac¬ 
hine is taken as 100. This is enough data base capacity to 
generate a "very black" picture, which is actually covered with 
lines about 2.5 times. In a typical 48 K system (the smallest 
size recommended) this number hovers around 65. This is still a 
very large capacity. The usual problem encountered, when this 
limit is exceeded, will be some loop in the program which tends 
to draw the same line or figure thousands of times. 

PLOTS: 

The purpose of PLOTS is to begin the plotting process. It MUST be 
used once, and once only, to initialize the process. It defines the 
type of hardware available to the software. If any hardware parame¬ 
ters are modified, they must be modified prior to the call to PLOTS. 
It effectively specifies that an origin exists at the lower left 
corner of the drawing area, which is set to 8 by 10 inches, for dot 
matrix printers, type 0 and 1, or to 15 by 10 inches, for the dot 
matrix printers, type 2 and 3. This origin is of no real consequen¬ 
ce on pen plotters or similar devices, which do not require the 
extra vector to raster scan conversion step after the plotting is 
finished. These devices usually allow the user the pleasure of 
manually positioning the "pen" at some "nice" place before he begins 
the plotting procedure. 

The practice of specifying the origin at the lower left-most posi¬ 
tion is both easily understood and most logical, until one realizes 
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that the line qcaphing routines will tty to label the axis BELOW and 
to the LEFT of this point. Obviously this will result 
of the Dictuce, sincV the dot matrix printer is unable to 

?Lt area. The extended form of the PLOTS verb is PLOTSU, which 
addresses this problem. 

This^is used as a convenient way to specify that a one 

Is used ^n the "windowed" plotting devices such as a dot matrix 

printer. This allows the extra room U°e 

tne orioin to draw the tic marks, annotation, and titles tor ii 
«Lhs This inch is usually a -sufficient" offset amount, unless 
Unusually long annotations ate used. The equivalent structure wou 
be found in the use of the PLOT verb by saying: 

CALL PLOT (1.0,1.0,-3) (FORTRAM) 

PLOT 11-3 BHD (COMMAND PILE / INTERACTIVE) 


SYNTAX 

PLOTS hardware statement (2SPEEO and XYSIXE must be 

here, if used) 

PLOTSX hardware statement (2SPBBD, XYSI2B, ...V 

where: 

The hardware statement is one or more of the following options. 

HARDWARE FORTRAN COMMAND PILE 

(third parameter) 


eight-inch wide dot 
matrix printer 
"dense mode" 

0 

TYPE 0 

eight-inch wide dot 
matrix printer 
"fast mode- 

1 

TYPE 1 

13.6 inches-wide dot 
matrix printer 

"dense mode- 

2 

TYPE 2 

13,6 inches-wide dot 
matrix printer 
"fast mode 

3 

TYPE 3 

Your Pen Plotter 4 


TYPE 4 

Your Graphics CRT 

5 

TYPE 5 

Your Word Processing 
Printer/Plotter 

6 

TYPE 6 


INSTALL may be used to place any item you define as types 4, 5 or 6 
(See Install Section.) 
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REORAM: 

The purpose of REDRAW is to produce a new picture from a picture 
previously saved by the PLOTNARE-z system. The picture must have 
previously been created by a run through a PLOTWARE-z program with 
the plotter deviced specified as the PICTURE BUFFER. The output of 
this was a file called PL0TWARE.8UF. It can be renamed to other 
standard names though any external means. The referencing of that 
file can then be made to draw another picture. This is a convenient 
way to compose complex presentations, ship pictures to other loca¬ 
tions without shipping your software, and transmit final pictures 
from one location to another by electronic means. Since colors and 
large sizes are preserved, it gives a graphics user with an inexpen¬ 
sive praphlcs device (such as a dot matrix printer) the ability to 
refine his output to the final stage, then transmit the finished 
picture (in the full size, with colors and other enhancements) to 
some central site for final display. 


SYNTAX 

COMMAND PILE Ot INTERACTIVE: 

(form 1): 

REDRAW "filename* 

(form 2): 

REDRAW (PPACTOR XPl YPl ANGLE) "filename" 

(form 3): 

REDRAW (PPACTOR XPl YPl ANGLE XP2 YP2) "filename* 

It can be seen that this is an identical form to the PLOT 
statement for displaying data in disk files. Refer to that module 
for further explanation. 

SCALE: 

The purpose of SCALE is to produce a convenient transformation from 
the "raw data" that is to be plotted, with its natural tendency to 
be just about any range of numbers imaginable, to the necessary inch 
measurements of an X - Y graph. It will also produce reasonable tic 
mark annotations for the size graph requested, in such a manner as 
to present an "even" appearance. 

SCALE does not recompute any numbers it examines. Hence it does iwt 
require duplicate storage or extra overhead requirements from the 
computer. It does produce a "starting value" and an "Increment 
value", referred to as FIRSTV and DELTAV respectively. These will 
later serve as factors to be used when plotting the graph. These 
factors are also used by the axis labeling routine and are always 
stored in two extra locations above the X - Y data. If the user 
wishes to compute his own PIRSTV and DELTAV, they should be stored 
there, if the subroutine LINE is used. Otherwise they may be passed 
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See AXIS for more 


directly as parameters to the AXIS routines, 
details on PIRSTV and DBLTAV. 

SYNTAX 

Fortran "compatible" form; 

CALL SCALB(ARRAY,AXLeN,NPTS,INC) 

FORTRAN "extended" form: 

CALL SCALBX(ARRAY,AXL£H,NPTS,INC,TICPACTOR) 

Fortran LOGARITHMIC form: 

CALL SCALBL(ARRAY,AXLBM,NPTS) 

COMMAND PILE or INTERACTIVE: 

SCALE X or y,AXLEM,NPTS,INC 
SCALEX X or y,AXLEN,NPTS,INC,TICPACTOR 
SCALBL X OC ¥,AXLBN,MPTS 

SCALBM X or Y,PIRSTV,DBLTAV (for manual scaling) 
where: 

ARRAY: 

This is the dimensioned (in Fortran) array which houses the data 
to be scaled. It will usually be either an array of X values or 
f 'ytmf an array of Y values. 

AXLBN: 

This is the length, in inches, of the AXIS which is to serve as 
the reference for that array. If the data is the X data, then 
this length will be the length of the X axis. 

NPTS: 

This is the number of points in the array. In the COMMAND PILB 
and INTERACTIVE modes, this may be zero, and the data will be 
counted by the software. 

INC: 

This can be used for two purposes. It will specify if the axis 
is to reflect data in a "descending" fashion (annotation wise) 
or in an "ascending" fashion. It will also give the option of 
selecting only a portion of the data in the ARRAY, at regular 
intervals, for the scaling calculation. 

If INC is greater than zero, the data_will be plotted with 
"ascending" notation. The value calculated for PIRSTV will be 
the minimum value which the software will expect to find in the 
data for that axis. 
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If IMC is less than zecot the data will be plotted in a "desce¬ 
nding" inannec. The annotation of the tic macks will descend as 
the axis pcogcesses. The PIRSTV calculated will be the maximum 
value that the software will expect to find in the data, foe 
that axis. 

The ABSOLUTE VALUE of INC can specify that data is to be sampled 
at tegular intervals, other than 1. Pot instance, if INC is ■♦■3 
or -3 then every third point will be sampled to compute FIRSTV 
and OELTAV. 

STORAGE of PIRSTV and DELTAV; 

These values are stored in the next two locations above the 
data, in memory, when INC is +1 or -1. If not +1 or -1, 

then PIRSTV will be stored at the next specified interval from 
the last point selected for sampling, with DELTAV occupying the 
next specified interval after that used to store PIRSTV. 

TICPACTORi 

This is the distance between tic marks, as expected when the 
linear axis is drawn. It is expressed in inches. 

SCALEM: 

This allows "manual scaling". (See AXIS) 

SYNTAX 

SCALEM n PIRSTV,DELTAV 
where : n is X or Y 

This allows the user to insert manual parameters into the 
system. 


SYMBOL: 

The purpose of SYMBOL is to produce "drawn" alphanumeric lettering 
in the drafting style for annotating the graphs and for marking the 
data points on the drawn lines of an X-Y line graph. It is installed 
in the software, as delivered, with a "default character set" which 
is described in the examples page The first fourteen characters 

are symbols which ate centered on data points of X-Y line graphs for 
point accentuation. The remaining characters ace available as 
needed to build text or numbers for the plot. This character set 
may be changed by the user with optional software, allowing the 
inclusion of mathematical symbols, script lettering, foreign text 
Characters, and the like.(See POUT) SYMBOL allows the text gene¬ 
rated to be any reasonable size, with centering, or right or left 
justification about a point. The text may also be rotated any 
number of degrees about that point. If the optional "ORNATE FONTS 
are installed, this character information is gathered from the last 
call to PONT. 

SYNTAX 
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Poctran: (standacd, "compatible" call) 


CALL 
extended 
CALL 
CALL 
CALL 
COMMAND PILE 


SYMBOL(XPAGB,YPAGE,HEIGHT,"teat".ANGLE,NCHAR) 
calls (left justify, center, right justify) 
SMBOLL(XPAGB,YPAGE,HEIGHT,"text",ANGLE,NCHAR) 
SMBOLC(XPAGB,YPAGE,HEIGHT,"text",ANGLE,NCHAR) 
SMBOLR{XPAGB,YPAGE,HEIGHT,"text",ANGLE,NCHAR) 
or INTERACTIVE : same, without parentheses. 


where: 


XPAGB,YPAGE: 

This specifies a point where the characters are to be referen¬ 
ced. This is the lower left of the left-most character position 
if the text is to be left justified, the lower right of the 
right-most character, if it is to be right justified, or the 
mid-point between these two points, if the text is centered. 


HEIGHT: 

This is the height, in inches, of each character used to make up 
the text. 

"text": 

This is the literal string or logical array, which is to be 
drawn on the plotting area. 

If "text" is displayed as ASCII characters, the first character 
of this text is always zero or greater than zero. A special 
case exists when "text" is taken as a single variable (logical 
or integer), whose value is between -1 and -14, inclusive. 
This allows the access of the "centered symbols" of the first 
fourteen positions of the chart, for accentuating points. When 
this occurs for "text",only one symbol is drawn. 

ANGLE: 

This ia the angle at which the text is to be rotated, as refere¬ 
nced to the plotting surface. The rotation occurs about the 
point referenced by XPAGB, YPAGE. 

NCHAR: 

This determines the number of characters of text which are to be 
displayed, provided that NCHAR is greater than or equal to zero. 
If NCHAR is less than zero, a centered symbol, selected from the 
first fourteen symbols of the chart, will be drawn at the point 
referenced- If NCHAR is -1, the pen is "tip" while moving to 
that point. If NCHAR is -2, the pen is "down" while moving to 
that point. The symbol generated is determined by tne absolute 
value of the logical variable used in the pl'Ace of "text". 

For compatibility reasons, tne following feature is included: 
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The "continuation feature" on XPAGB and/or XPAGB: 

When X is equal to 999.0, then X is continued from the x posi¬ 
tion where the last SYMBOL call left off. If Y is equal to 999.0 
then Y is continued from the Y position where the last SYMBOL 
call left off. If both ate equal to 999.0 the drawing of text 
continues immediately from the final position of the previous 
call to SYMBOL. 

WHBRB: 

The purpose of HBBRB is to provide a "feedback” mechanism in the 
FORTRAN versions to indicate the current position of the "PEN". 
This is not usually needed, as the location of the pen is usually 
apparent to the programmer. However, in the case of using PLOTHARB- 
z* calls, which perform their own pen commands, such as SYMBOL or 
NUMBER, it is sometimes helpful to know just where the "PEN" finis¬ 
hed drawing. This call will return the information of that location 
to the programmer, as well as returning the current "factor" which 
is in effect. 


SYNTAX: 

CALL WHBRB(RXPAGB,RyPAGB,RFACr) 

XYSIXB: 

The purpose of XYSIXB is to provide a different sized plot from the 
normal 8 x 10 or 10 x 13.6 provided by dot matrix printers. 

This routine is a subroutine under FORTRAN: 

CALL XYXIZB (XLENG,YHTl,YHT2) 

where: 

XLBNG is the new standard page length for the printer. 

YHTI is the new height (carriage width) for the narrow printer. 

YHT2 is the new height for the wide printer. 

In the COMMAND PILB format, this MUST be on the PLOTS command line. 
It cannot be elsewhere. 

Examples: 

FORTRAN: 

CALL XYSIXB (100.,8.,13.6) (creates LONGGGGG plots) 

COMMAND PILE : 

PLOTS ... XYSIXB 5 8 13.6 ... (creates short plot) 
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ZPBRSX: 

The purpose of IPBRSX is to define the perspective of the user for 
three dinensional projections. The concept of three dimensions is a 
complex one, and the full explanation of that concept is not the 
purpose of this manual. A short summary of this follows, however. 


Two approaches to three dimensions are usually taken. The first, or 
traditional method, introduces the concept of some imaginary “van¬ 
ishing point" where all parallel lines of an object seem to con¬ 
verge. Drafting technicians and engineers often call the usage of 
this concept “orthogonal projection*. A more realistic view is found 
when two vanishing points are used, letting the object be rotated 
about 45 degreed and letting the observer view the object “head-on". 
If the object consists of mostly conventional shapes ^rectangles, 
smoothly curved surfaces, etc.) the appearance is somewhat realis¬ 
tic. The most realistic of the “traditonal approach" methods is the 
usage of three “vanishing points", where the viewer usually “looks 
down" or “looks up" at the object. 


Two severe drawbacks are found in this approach. The first is that 
rotation of the object is severly hampered, because the realistic 
appearance of the view is highly dependent on the angle to the 
observer. The second drawback is this: the model is not based on 
sound mathematics, but on some “seat of the pants" guess or some 
“pleasing to the eye“ decision. With some calculations, one may 
produce “vanishing points" that are close to the mathematically 
correct points, but for the purpose of this program, this approach 
is discarded. 

The second approach (as used in PLOTWARE-z) is to define an object 
in matrix form (in this case 3x3) and mathematically derice the 
true projection into a plane that is perpendicular to the viewer. 
This plane is obviously analgous to a CRT screen, the finished 
drawing from your dot matrix printer, plotter, etc. The viewer can 
then get as close to or remove himself as far away form the origin 
of the object (expressed in X, Y, Z form) as he desires. He can, of 
course, even place himself WITHIN the object prior to viewing, but 
the finished product may appear somewhat confusing. The viewer may 
also position the screen at any place. This allows for a very wide 
range of magnification and reduction. In addition to this, he may 
RESPECIPY the X, Y, Z origin at any time or directly rotate the X or 
Y plane prior to it projection. 

The derivation of this is found in many books. The parametric sum¬ 
mary is as follows: 

a. There exists an object to be viewed, expressed as a set of 
X, Y, and Z location points. 

b. There is an observer whose “single point of observation" 
is at some point. This point is at an angle with respect to 
the Z axis of the object. This angle is refelrred to as THETA. 

c. The observer is a distance away from the-X, Y, Z origin of 
the viewed object. This distance to the “single point of 
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observation" (close one eye please!) is RHO. 

d. Tbe observer, in addition, is some angle away from the )t 
axis of the object. This angle is PHI. 

e. Finally, tne observer is "looking at" (with his one eye, 
of course - keep the other closed during this explanation) 
the projection of the object onto a screen. The observer is 
some distance away from the screen. This distance is D. 

Here are some practical exercises to use to confirm these concepts 
mentally. 

Place a sheet of paper on a table in front of you. This is an X-Y 
plane. 

a. Stand directly over it and look down directly on it. At 
this point the Z axis is directly through your "line of 
site". At this point, PHI is 0. 

b. Rotate the paper COUNTER-CLOCKWISE. You have just move the 
paper in the THETA direction, positively. YOU, however, as 
the Observer, have experienced a NEGATIVE shift in THETA, 
relative to the paper. You could, of course, have directly 
simulated this by walking to the LEFT, 

c. Draw back away from the table. You have just changed your 
your PHI positively. You no longer look directly down at the 
paper ("looking directly down means zero degrees PHI), 

d. Imagine tne "cone of vision" formed by the left-most, the 
right-most, the bottom-most, and tne top-most parts of the 
observed item (the piece of paper). This cone of vision (in 
this case, more of a pyramid) holds the key to the concept of 
the "screen of projection". At any place in this cone of 
vision, you may place the screen, as long as it is 
perpendicular to your line-of-sight. Now you can see that the 
screen becomes your final resting place for your image. It 
can be from the plotter, the dot matrix printer, or your CRT 
graphics screen. The screen is not limited to position 
between your viewpoint and the object. It may be BEHIND the 
object. In this way, it MAGNIFIES the object. Use this, of 
course for display of small objects. When between the 
observer and the object, it REDUCES the object. Use this for 
large objects. The distance to the observer is 0. 

e. One last experiment will cement the concept of Z into the 
picture. The paper rests on the table, it references the X-Y 
plane on its surface. The actual X-Y plane is the table top, 
tor tnis purpose. Now carefully raise tne paper and assume 
tnat it is exactly parallel to the table,top, but one inch 
above it. You have just changed tne Z of tne object from 0 to 
I. 

t. In reference to tne table top, you may change tne origin 
at any convenient time. Use N300RG X Y Z in the COMMAND FILE 
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mode oc PLOT3D(X, V, Z3) in the compiler mode to move this 
reference point. 

THIS IS THE ONLy EXPLANATION OP N300RG. 

The SYNTAX is now presented. 

SYNTAX; 

COMMAND PILE mode: 

ZPERSX RHO,THETA,PHI,0,Z 
compiler mode: 

CALL ZPERSX(RHO,THETA,PHI,0,Z) 

Try this to get started (in CHART): 

PLOTS TYPE n 
PLOT 11-3 END 

PLOT 003 052 552 502 002 END 

EXIT 

This draws a 5 x 5 box. 

Now: 

/ PLOTS TYPE n 

PLOT 11-3 END 
ZPERSX 5 -90 30 5 0 

PLOT 003 052 552 502 002 END 

EXIT 

This draws the same box tilted AWAY (from the -90) from you and 
at a 30 degree angle (PHI), 

ZPBRSY: 

The purpose of this module is to cancel the effect of ZPERSX and 
return to two dimensional representation. 

SYNTAX: (COMMAND FILE) 

ZPERSY 

ZSPEED: 

The ZSPEED command is used for certain EPSON printers which cannot 
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proper data handling 
This is particularly 


without loosing data at high 
directed toward the buffered 


speed 

inte- 


The standard factor 


is 16 (4 times a 4 MHZ processor speed). 


The following factors are used for other 


common processors: 


13 - The INTERTEC QD and COMPUSTAR (uses 
amount of CPU for screen handling - 
slower execution) 


significant 
results in 


d - For 2 MHZ processors (a080« zaO, etc.) 

9 - For 8085 with 5 MHZ crystal 

15 - For 8085 with 10 MHZ crystal (using typical wait 
states) 

24 - For the ENERCOMP TWIN - 2 processor (or other Z-80 
processors with 6 MHZ CPU) 

Adjustment may be made downward for wait states. 


examples 


FORTRAN : 

CALL ZSPBBO (ISPEBD) 


COMMAND PILE : 

PLOTS ••• ZSPBBD 24 .... 


ZSWAPX: 

This rotates the plane on the X ax^is 90 degrees into the Z axis 
effectively "swaps the X and the Z“. 


It 


SYNTAX: (COMMAND PILE) 


ZSWAPX 


ZSWAPY: 


Tnis rotates the plane on the Y 
effectively "swaps the Y and tne 


axis 90 degrees 

Z". 


into the Z axis. It 


SYNTAX; (COMMAND FILE) 


ZSWAPY 
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♦ ,HS TIST FILE FOR AIIS GFNfRATlOH "TESTA X1S .Chp" ««*«=>* 



.OTS TYPE 4 
rlCT -.5 -.5 -2 
FATA "TFSTFATA .LOG 
SCALE! X 8 0 1 .4 
SCALFL T e e 


iCALFL T e^e - a o ca a A -K 

■jANFEBI-ABAFEi-ATJUNJUlAUGSEFOCINOVrFCJANFF.BMARAPRr^ATJUNJULAnGSFFOrTNOVrP( 

IXISLG 0 0 "LCG T axis’* S£ F £0 P£ 0 


0 9 £ 


TTMSTfZ 1 0 F 0 1 .4 

^ipOLC 4 e.t .1? ■'TEST OF FXTFNLED AN! LOG SUBPCFTINf S: 

SI-BOLC 4 e.2 .1? "LINE, SCALE. AML AXIS 0 99 

PICT e 0 0 ENI 
LATA "TFSTCATA.LOG 
SCALE! Y € 0 1 .6 

SCALEI X e.0 , - ^ « T 

-^INFEB^'5pA^R?A^J^Ni!luI^L?ScTN0VEECJAHFFBH;RAPRKAYJUNJULAUGSVF0CTN0VDV> 

A7ISIG 0 0 "iCC X AXIS"-e9 8 0 £9 0 

^iloLC 4 e.5 ?i2'"TFST of EXTFNLFD ANL log SUPROUTIHFS:’’ 0 99 

SPBCIC 4 6.2 .12 lINF, FCAIF, ANL AXIS 0 9S 

PLOT 000 ENL 
LATA "TFSTLATA.LOG 
'CALEl Y € 0 


AXIS" 99 e 90 99 0 
AXIS"-££ 8 0 £9 0 


8 0 

0 "LOG T 
0 "ICG X 

2 2 £ g 

e .1? "TEST OF LOG-LOG SUBROUTINES:' 
6.2 .12 "IIKF, SCAII, AN! AXIS* 0 PC 


0 99 


.CALIL X 
AXISLG 0 
A7ISIG 0 
LINEIG 1 
SfPOLC 4 
SHBOIC 4 
PLOT 0 0‘ 0 ENL 
DATA "TFSTCATA.LOG 
SCALFL Y e 0 
SCALE! 180 
CRIC 8 .1 0 
AXISLG 0 0 “log Y 
GRID 6 .Gf 0 
AXISLG 0 0 "LOG X 
1N £ T>G 1 0 0 0 

'PBOLC 4 €.5 .10 "TFST OF LOG-LOG SUP.POUTINFS WITP GRID: 
SA*BOLC 4 6.2 .08 "LINE. SCALE, ANL AXIS" 0 9S 


axis" 99 e 90 99 0 
AXIS"-£S 8 0 £S 0 


0 £9 


prOT P 0 0 ^NC 
DATA lESYEAYA.ICG 
SCALFL Y € 0 
SCALFL X 8 0 
CRIC 800 

AXISLG 0 0 “LOG Y AXIS ££ 6 £0 99 0 
3RID P 0 0 

AXISIG 0 0 'iCG X AXIS -££ P 0 £9 0 
LATA “TESTtATA.001" 
scale X 5 0 1 
SCALE 7501 

AXIS 0 0 “X AXIS -££ 5 0 ££ 0 


K'3r 



4 


iXiS 0 «■ "T axis" 99 5 90 S9 0 
LINE 10100^ 

SI-BOIC 2.5 e .12 TFST Cf STANtAHr SPPBCUTINJS: 0 99 

ShBOLC 2.5 e.e .1 “LINE, SCALE, ANt AXIS" 0 99 
PICT 0 0 0 ENI 
DATA "TFSTrATA.002" 

SCALE! 1001 .4 
SCALE! T e,0 1 .€ 

AXISA K 0 EXT. X AXIS -99 8 0 99 0 .4 0 
AXISA 0 0 “ext. T axis" 99 6 90 99 0 .61 
LINE! 1 0 1 0 0 .4 .6 

SMPOLC 4 e.S .12 TEST OF FXTFNtFC SUEROUTINFS; 0 99 
SMBOLC 4 6.3 .12 “lINK, SCALE, AND AXIS" 0 99 
PIOT 0 0 0 FNE 
DATA "TESTEATA.002“ 

SCALE! X 6 0 1 .4 
SCALE! Y € 0 1 .6 

AXISB 0 0 "ALPPA X ANNOTATION” -99 8 0 99 0 .43 

"jANEFBKARAFFI'ATJrAJllAl'GSFPCClKCfrECJANFFEMARA.FFKATJUNJULAUGSEFOrTNOV 
AXISA 0 0 "EXT. T AXIS" 99 6 90 99 0 .61 
LINE! 1 0 1 0 0 .4 .6 

S6P0IC 4 e.£ .12 "TEST CF EXTFNTFE SUFFCUTINESr 0 P9 

S6BOLC 4 e.2 .12 "line, SCALE, AMT AXIS" 0 99 

PLOT 0 0 0 ENL 

PICT .£ .£ -2 FEE 

EATA "TFSTrATA.002" 

SCALE! X 8 0 1 .4 
SCALE! T € 0 1 .6 

AXISE e £ "45 EEGREE ALPHA X ANNOTATION -99^8 0^99 0 ^4^23 ^ 

"GPOUP A" “GBOUF B: :SEG^1: ;S|G^2: 3 T^l. T-2 T-; 

"T-4" "T-£" T-e A B C I I TEST 10 TFST XTZ TEST CHFCI 
"X-r "X-2" "x-3" "X-4" 

AXISC 0 0 90 DEGREE ALPHA Y NOTATION 99 6 90 99 0 .6 11 ^ ^ ^ 

"N-l" "n-2" "n-3" "n-4" "fIFTB" "SIXTH" "SEYENTR" EIGHT 9TH 10 
LINEI 1 0 1 0 0 .4 ,6 

SKBCIC 4 6.0 .12 "test CE EXTFNIEE SUFRCUTINFS: 0 99 

SKPOIC 4 £.8 .12 "line. SCALE, AND AXIS" 0 99 

EXIT 


**«<■*=> TFST FCB PAPCHABT CCMPANIS "PAFCBABT .CPE" 

PLOTS TYPE 4 

SA-BCIC £ £ .14 "aFFEKEIX B - ANNUAI RFFCRT"0 99 

CHART PAR 1.2 .6 3 3 1 0 .32£ "EXPENSES. 10e0'S" "SAIFS PERSON 

DATA "TAYLOR" 65 62 3 20 

EATA "S.SF*ITH" 79 70 3 20 

DATA "F.Sr^ITP" 62 60 3 20 

DATA "PPOi<n" 40 30 3 20 

SNE 

SF-BOLC 2.£ 4.£ .12 EXPENSE RFFOBT FT INEIVirUAE 0 99 

S6B0IC 2.£ 4.3 .09"SHAEEC PORTION IS TRAVEL-PFlATFL EXPENSE" 0 99 

S6F01C 2.£ 4.1£ .085 "FOR THE PEBIOE 1-00 THFU. 12-80" 0 99 

CHART PAP 6.2 1.5 3 2 0 .25 .£ "VARFHOUSES. BY LOCATION * "CAPACITY (K 

DATA "PITTSFIFG" 92 85 5 20 


K-3G 















DATA "T8¥NT0N" 6e 23 2 2? 

DATA "MIAMI" fl 2 20 
DATA "ATLANTA*- 85^65 3 20 
DATA "BATON ROUGE 72 42 2 
DATA "HOUSTON" 96 96 3 20 
LATA "SAN EIIGC 23^21 2 20 
DATA "SAN JHANCISCO 67 80 2 
DATA "PORTLAND" 96 46 3 20 

IISJnTr 7 ' 4.^ .12"NAB¥HCtSE TACIIITT REPORT" 0 96 

^KBOLC 7 * 4 3 .09"SPADFD PORTION INDICATES FIlIEIi CAFACITT ^ ~ 

7 - 4.16 !e9 "DENSE PCBTICN SBCNS SECUPITT-SENFITIVE FRCDUT 0 ? 
SMBOIC 7.6 3.9 .065 "REFLECTS CAPACITT NOTED IN JANUARY, 1901 REPORT 0- 

E7IT 


##*««* tyst for fif chart "ajaxpie-cmd" 


PLOTS TYPE 4 
PICT 0 12 -3 TAL _ 

SMBCII 6 7.6 .26 COST BFEAKICEN - 

SMPOLI 6 7.2 .12 'DEMONSTRATION OF 

CHART FIE 6 3.75 6 

DATA "OIFRHEAD 25.6 

DATA "labor" 16.2 

DATA -1 "MATERIAL 11.6 

DATA machines 10.2 

DATA "gas" 1.0 

DATA "TCCIS^ e.4 

DATA PO^FR^ 6.3 

DATA "LEGAL 6.6 

DATA ^FNICN"^.? 

DATA INSUR. 9.1 
DATA "other" 4.3 
END 
EXIT 


AJAX NTIGET CC. 
"graph" ROUTINE' 


e S6 1 
0 99 1 


«*«««» TEST FOB NUMBERS AND SYMBOLS "TESTNMST .CMP 


PLOTS TYPE 4 
FACTOR .9 
PICT 0030 
SMBOIC 3.9 4 
SYMBOL .2- 0 
SMBOIl .4 0 
SMBOLC .e 4 
SMBOLE .6 8 
NUMBER 1.6 . 


423420420P24®240P002FND 

.26 'TEST OE SYMPCL S AVMPER' 90 69 
.12 'STANDARD SYMBOL CALL' 90 20 
.12 'SMBCll CAIL (LEFT JUSTIFY) 60 2f 
.12 'SMBOLC CALL (CENTER)' 90 20 
.12 'SMPOLR CALL (RIGHT JUSTIFY) 90 27 
1 .12 12.346 60 3 


NUMBER 1.6 3 .12 12.346 60 2 
NUMBER 1.6 e .12 12.345 60 I 


NUMBER 1.7 .1 .1? 12.346 60 0 


Nt^'BFP 1.7 3 .12 12.346 60 -1 
NUMBER 1.7 e .12 12.346 60 -2 
NUMBRL 2.2 0 .12 12.345 90 3 




NUKBPC 

NITBRE 

NlIMBfR 

SMPOLC 

STMBCL 

ST^'BOl 

SYMBOL 

SYMBCl 

SYMBOL 

SYMBOL 

STMBCI 

SYMBOL 

SMBOLC 

FTIT 


2,2 

2.2 

2.e 

e 4 

c ^ c 

S99 

999 

999 

999 

999 

999 

999 

6.2 


4 .1? 12.245 90 2 

8 .12 12.245 90 2 

e .12 55.555 90 2 

2*1 'TFST OF ROTATION' 98 99 
2.75 .14 '.RCTATf.' 0 99 
, 999. .14 '.ROTATf.' 45 99 
. 999. .14 '.ROTATF.' 90 99 
. 999. .14 '.RCTATY .'125 99 
. 999. .14 '.ROTATi.*180 99 
. 999. .14 ' .ROTATF.'225 99 
. 999. .14 '.RCTATf.*270 99 
999. .14 ' .ROTATF. *215 99 


2*4 .15 'CRFATFD BY “Tf STNMSY.CMD*" 90 99 


A; *30 
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APPENDIX B - ANNUAL REPORT 
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»-• 21 •• 


>. -io 
CD ^ • 



N0su3d sanus 


STPMOflnO SYMBOL CRLL 
iHBOLL CRLL (LEFT 

“ *^^**SMB0LB CALL (BIGHT JUSTIFY 

12.34S 

12. 

CM<\I 



12.3 

1 

12.345 

12. 

J4S 


12.34 

>5.56 
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STANDARD CHARACTERS 

LISTED WITH HEX AND DECIMAL EQUIVALENTS 


00 0 

0 

30 


32 

40 

0 

48 

50 ® 

64 

60 

P 80 

01 O 

1 

31 

1 

33 

41 

1 

49 

51 fl 

6S 

61 

Q 81 

02 ^ 

2 

32 

ff 

34 

42 

2 

SO 

52 B 

66 

62 

R 82 

03 + 

3 

33 

u 

35 

43 

3 

51 

53 C 

87 

63 

S 83 

04 X 

4 

34 

$ 

36 

44 

4 

52 

54 D 

68 

64 

T 84 

OS ^ 

S 

3S 

•/ 

37 

4S 

5 

53 

SS E 

69 

65 

U 85 

06 

6 

36 

& 

38 

46 

6 

54 

56 F 

70 

66 

V 86 

07 X 

7 

37 

r 

39 

47 

7 

SS 

57 G 

71 

67 

W 87 

08 Z 

8 

38 

( 

40 

48 

8 

56 

58 H 

72 

68 

X 88 

X 

CD 

o 

9 

39 

) 

41 

49 

9 

57 

59 I 

73 

69 

Y 89 

obX 

10 

3fl 

X 

42 

49 

• 

m 

58 

5fl J 

74 

6R 

Z 90 

OB X 

11 

38 

+ 

43 

48 

m 

f 

59 

SB K 

75 

66 

C 91 

ocX 

12 

3C 

9 

44 

4C 

< 

80 

SC L 

76 

6C 

\ 92 

00 1 

13 

30 

- 

4S 

40 

— 

61 

50 M 

77 

60 

I) 93 


3C 

• 

46 

4E 

> 

62 

SE N 

78 

6C 

✓s 

94 

• 

3F 

/ 

47 

4F 

? 

A 

63 

5F 0 

79 

6F 

— 95 





